========
Overview
========

.. contents::
   :local:
   :depth: 1

This page describes the tabs, menus, and buttons in the Anaconda
Navigator window.

.. figure:: /img/navigator-home-1-6.png
   :width: 50%

   ..

|

The tabs in the left column represent the main components in Navigator.
Click a tab to open it.

TIP: To learn more about terms used in Anaconda, see the :doc:`glossary`.

**Home** tab
============

The **Home** tab, shown in the image above, displays
all of the available applications that you can manage with Navigator.

The first time you open Navigator, the following popular graphical Python
applications are already installed or are available to install:

* `Jupyter notebook <https://jupyter.readthedocs.org/en/latest/>`_
* `Orange data visualization <http://orange.biolab.si/docs/>`_
* `Qt Console <https://media.readthedocs.org/pdf/qtconsole/stable/qtconsole.pdf>`_
* `Spyder IDE <https://pythonhosted.org/spyder/>`_
* `Glueviz multidimensional data visualization <http://glueviz.org/en/stable/>`_
* `R Studio IDE <http://docs.rstudio.com/>`_

You can also `build your own Navigator applications <https://conda.io/docs/build_tutorials/app.html>`_.

In each application box, you can:

* Launch the application--Click its Launch button.
* Install an application--Click its Install button.
* Update, remove or install a specific version of an application--Click
  the gear icon in the top right corner of the application box.

Applications are installed in the active environment, which is displayed
in the "Applications on" list. To install an application in a specific environment,
first select the environment in the list, then click the application's Install
button. You can also create a new environment on the **Environments** tab,
then return to the **Home** tab to install packages in the new environment.

Licensed applications
---------------------

Some applications require licenses. To see the status of all licensed
applications and add new licenses, on the **Help** menu, select License Manager.
For more information, see :doc:`tutorials/manage-licenses`.

**Environments** tab
====================

The **Environments** tab allows you to manage installed
:ref:`environments <navigator-glossary-conda-environment>`,
:ref:`packages <navigator-glossary-conda-pkg>`
and :ref:`channels <navigator-glossary-channels>`.

.. figure:: /img/navigator-environments-1-6.png
   :width: 50%

   ..

|

The left column lists your environments. Click an environment to activate
it.

With Navigator, like with conda, you can create, export,
list, remove and update environments that have different versions of
Python and/or packages installed. Switching or moving between
environments is called activating the environment. Only one environment
is active at any point in time. For more information, see :doc:`tutorials/manage-environments`.

The right column lists packages in the current environment. The
default view is Installed packages. To change which packages are displayed,
click the arrow next to the list, then select Not Installed, Upgradeable or All
packages. For more information, see :doc:`tutorials/manage-packages`.

Channels are locations where Navigator or conda looks for packages. Click
the Channels button to open the Channels Manager. For
more information, see :doc:`tutorials/manage-channels`.


**Projects (beta)** tab
=======================

The **Projects** tab allows Anaconda Projects users to create, import, remove,
edit and upload Anaconda Projects. Projects are an easy way to encapsulate
your data science projects and make them easily portable. Project automates
setup steps such as installing the right packages, downloading files,
setting environment variables and running commands.

NOTE: Projects is still a beta feature.

The first time you click the Projects (beta) tab, you will set the
path for your projects. The default is ``users/<your-username>/AnacondaProjects/``.
Accept the default or choose your own path. After selecting the path, you
will see the Projects screen:

.. figure:: /img/navigator-projectsbeta-1-6.png
   :width: 50%

   ..

|

Manage your Projects as follows:

* Create a new Project--Click the Create button and give the project a name.
* Import a Project--Click the Import button and select the project file from your computer.
* Remove a Project--Click the Remove button, then verify that is the Project you want to remove.
* View Project files--Click the top Files tab.
* Edit a Project--Click the top Edit tab, edit the file, then click the top Save button.
* Upload a Project to Anaconda Cloud--When finished editing, click the bottom Upload to Anaconda Cloud button.

NOTE: To upload a Project, you must have an Anaconda Cloud account and be logged in.

To learn more about Anaconda Projects, see the `Anaconda Project
documentation <http://anaconda-project.readthedocs.io/en/latest/>`_.

**Learning** tab
================

On the **Learning** tab you can learn more about Navigator, the Anaconda
platform and open data science. Click the Webinars, Documentation, Video,
or Training buttons, then click any item to open it in a browser window.

.. figure:: /img/navigator-learning-1-6.png
   :width: 50%

   ..

|

**Community** tab
=================

On the **Community** tab you can learn more about events, free support
forums and social networking relating to Navigator. Click the Events,
Forum or Social buttons, then click any item to open it in a browser window.

TIP: To get help with Anaconda and Navigator from the community,
join the `Anaconda forum <https://groups.google.com/a/anaconda.com/forum/#!forum/anaconda>`_.

.. figure:: /img/navigator-community-1-6.png
   :width: 50%

   ..

|

**File** menu
=============

The Navigator **File** menu (on macOS **Anaconda Navigator**)
contains the following options:

* About--displays information about Navigator, including a link for bug
  reports and feature requests. (In Linux this is in the Help menu.)
* Preferences--allows you to set your Navigator preferences. In the
  Preferences window you can:

  * Reset the Anaconda API domain to point to a local Anaconda repository
    instead of Anaconda Cloud.
  * Enable or disable SSL.
  * Toggle the option to provide personally non-identifiable information
    to help improve the product.
  * Hide the Quit dialog box when exiting the program.
  * Hide the Update dialog box when starting the program.
  * Hide the Close running applications dialog, which normally displays when
    exiting the program if there are still running applications that were
    launched from Navigator.
  * Modify Navigator's display with Enable High DPI scaling option. This option
    can be useful if Navigator isn't displaying correctly on some high DPI
    screens.

  TIP: Click the Reset to defaults button to change preferences back to
  their default values.

  .. figure:: /img/navigator-preferences-pane.png
     :width: 50%

     ..

  |
  
* Services (macOS only)--links to your computer's system preferences menu.
* Hide Anaconda Navigator (macOS only)--hides the Navigator window.
* Hide Others (macOS only)--hides all windows except the Navigator window.
* Show All (macOS only)--shows all windows including the Navigator window.
* Quit Anaconda Navigator--exits Navigator.

.. _navigator-help-menu:

**Help** menu
=============

The **Help** menu contains the following options:

* Search--links to your computer's Help (Windows and macOS only).
* Online Documentation--links to this documentation, which you can read
  in any web browser. You can also open the documentation by clicking the
  Documentation button at the bottom left of the Navigator window.
* License manager--allows you to add and remove licenses, and view details
  of licensed packages. For more information, see :doc:`tutorials/manage-licenses`.
* Logs viewer--allows you to review the logs of all actions performed
  in Navigator in the current session. This option displays a list of log
  files, including ``navigator.log``, which contains Navigator application
  logs, and ``condamanager.log``, which contains logs written
  by the conda-manager component.

  NOTE: A new log file is created every time you run Navigator, with a
  sequential number appended to the file name. More recent log files have
  higher numbers.


Navigator window buttons
========================

* Sign in to Anaconda Cloud--displayed at the top right.
  Click to sign into Anaconda Cloud (Anaconda.org) and enable searching
  for packages on it. After you have logged in, the button label changes
  to "Signed in as [username]."
* Documentation--displayed at the bottom left. Click to open Navigator
  documentation in a browser.
* Developer Blog--displayed at the bottom left. Click to read what our
  developers have to say about Navigator development.
* Feedback--displayed at the bottom left. Click to send us feedback
  about Navigator and help us make it better.
