==============================
Getting started with Navigator
==============================

Anaconda Navigator is a graphical user interface to the conda package and environment manager.

This 10-minute guide to Navigator will have you navigating the powerful conda program in a web-like interface without having to learn command line commands.

SEE ALSO: `Getting started with conda <https://conda.io/docs/user-guide/getting-started.html>`_ to learn how to use conda. Compare the  Getting started guides for each to see which program you prefer.

Before you start
================

You should have already :doc:`installed Anaconda <../install/index>` .

Contents
========

 - :ref:`Starting Navigator <navigator-starting-navigator>` on Windows, macOS or Linux. 1 MINUTE
 - :ref:`Managing Navigator <navigator-managing-navigator>`. Verify that Anaconda is installed and check that Navigator is updated to the current version. 1 MINUTE
 - :ref:`Managing environments <navigator-managing-environments>`. Create environments and move easily between them. 3 MINUTES
 - :ref:`Managing Python <navigator-managing-python>`. Create an environment that has a different version of Python. 2 MINUTES
 - :ref:`Managing packages <navigator-managing-packages>`. Find packages available for you to install. Install packages. 3 MINUTES

TOTAL TIME: 10 MINUTES

.. _navigator-starting-navigator:

Starting Navigator
==================

**Windows**

* From the Start menu, click the Anaconda Navigator desktop app.
* Or from the Start menu, search for and open "Anaconda Prompt" and type the command ``anaconda-navigator``.

.. figure:: /img/navigator-anaconda-prompt.png
   :width: 50%
   
   ..

|

**MacOS**

* Open Launchpad, then click the Anaconda-Navigator icon.
* Or open Launchpad and click the Terminal icon. Then in Terminal, type ``anaconda-navigator``.

**Linux**

* Open a Terminal window and type ``anaconda-navigator``.

.. _navigator-managing-navigator:

Managing Navigator
==================

Verify that Anaconda is installed and running on your system.

 - When Navigator starts up, it verifies that Anaconda is installed.
 - If Navigator does not start up, go back to Anaconda installation and
   make sure you followed all the steps.

Check that Navigator is updated to the current version.

 - When you start Navigator, it automatically checks for a new version. If Navigator finds a new version, you will see a dialog box like this:

   .. figure:: /img/navigator-new-update.png
      :width: 50%
      
      ..

   |

Click the "Yes" button to update Navigator to the current version.

TIP: We recommend that you always keep Navigator updated to the latest version.

.. _navigator-managing-environments:

Managing Environments
=====================

Navigator uses conda to create separate environments containing files, packages and their dependencies that will not interact with other environments.

#. Create a new environment named snowflakes and install a package in it:

   In Navigator, click the **Environments** tab, then click the Create button.

   The Create new environment dialog box appears.

   In the Environment name field, type a descriptive name for your environment:

   .. figure:: /img/navigator-tutorial01.png

      ..

   |

   Click the Create button.

   Navigator creates the new environment and activates it:

   .. figure:: /img/navigator-tutorial02.png

      ..

   |


.. _navigator-use-environment:

   Now you have two environments, base (the default) and snowflakes.
   Switch between them (activate and deactivate environments) by
   clicking the name of the environment you want to use.

   TIP: The active environment is the one with the arrow next to its name.

   Return to the other environment by clicking its name.

.. _navigator-managing-python:

Managing Python
===============

When you create a new environment, Navigator installs the same Python version you used when you downloaded and installed Anaconda. If you want to use a different version of Python, for example Python 3.5, simply create a new environment and specify the version of Python that you want in that environment.

Create a new environment named "snakes" that contains Python 3.5:

#. In Navigator, click the **Environments** tab, then click the Create button.

   The Create new environment dialog box appears.

#. In the Environment name field, type the descriptive name "snakes" and select
   the version of Python you want to use from the Python Packages box (3.6, 3.5
   or 2.7). Select a different version of Python than is in your other
   environments, base or snowflakes.

#. Click the Create button.

#. Activate the version of Python you want to use by clicking the name of
   that environment.

.. _navigator-managing-packages:

Managing packages
=================

In this section, you check which packages you have installed, check which are available and look for a specific package and install it.

To find a package you have already installed, click the name of the environment you want to search. The installed packages are displayed in the right pane.

You can change the selection of packages displayed in the right pane at any time by clicking the drop-down box above it and selecting Installed, Not Installed, Updateable, Selected, or All.

Check to see if a package you have not installed named "beautifulsoup4" is available from the Anaconda repository (must be connected to the Internet):

On the Environments tab, in the Search Packages box, type ``beautifulsoup4``,
from the Search Subset box select All or Not Installed, and click the bottom
Apply button.

To install the package into the current environment:

Check the checkbox next to the package name, then click the bottom Apply button.

The newly installed program is displayed in your list of installed programs.


More information
================

 - Full documentation---https://docs.anaconda.com/anaconda/navigator/
 - Free community support---https://groups.google.com/a/anaconda.com/forum/#!forum/anaconda
 - Paid support options---https://www.anaconda.com/support/
 - Training---https://www.anaconda.com/training/
