Anaconda Enterprise: Documentation

# 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 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 installed Anaconda .

## Contents

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

TOTAL TIME: 10 MINUTES

## 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`.

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`.

## 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:

Click the “Yes” button to update Navigator to the current version.

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

## Managing Environments

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

1. 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:

   Click the Create button.

   Navigator creates the new environment and activates it:

> 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.

## 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:

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

   The Create new environment dialog box appears.

2. 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.

3. Click the Create button.

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

## 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/