Managing environments#

On the Environments page, the left column displays your environments. At the bottom of the environments list are the Create, Clone, Import, Backup, and Remove buttons.

Searching for an environment#

In the Search Environments box, enter all or part of an environment name to filter the environment list.

Creating a new environment#

  1. At the bottom of the environments list, select Create.

  2. In the Create new environment dialog, enter a descriptive name for the new environment.

  3. Select Python or R to set the package type for your environment.

  4. Select a version for your Python or R installation.

  5. Click Create.

Using an environment#

  1. In the environments list, select the environment name to activate it.

  2. Click the arrow button beside the environment name to open the activation options dropdown.

  3. Select one of the following options for opening the environment: Terminal, Python interpreter, IPython Console, or Jupyter Notebook.

    Note

    Some of these options may not be available if they were not installed in the environment.

Cloning an environment#

  1. Activate the environment you want to clone by selecting it from the environments list.

  2. At the bottom of the environments list, click Clone.

  3. Enter a descriptive name for the new environment.

  4. Click Clone.

Importing an environment#

Environment creation information can be shared using a .yml-formatted configuration file. If someone has given you an environment file that you want to use—for example shared-environment-file.yml—and you have saved it to your computer, you can import it into Navigator. Furthermore, if you have backed up an environment either locally or to Anaconda Cloud, you can import it onto your local computer with Navigator.

  1. At the bottom of the environments list, select Import.

  2. Select Local drive.

  3. Click the folder in the Local drive section.

  4. Select the .yml environment file you want to import.

  5. Enter a descriptive name for the new environment, or use the existing name.

    Note

    Each environment name must be unique. To overwrite an environment with the same name, select the Overwrite existing environment checkbox.

  6. Click Import.

  1. At the bottom of the environments list, select Import.

  2. Sign in to Anaconda Cloud, if necessary.

  3. Select Anaconda Cloud.

  4. Click the folder in the Anaconda Cloud section.

    Tip

    If you do not want to immediately create a new environment, click Download environment file and save the environment to your computer. Click Cancel twice to close the Import dialog when finished.

  5. Select the environment you want to import.

  6. Click Select.

  7. Enter a descriptive name for the new environment, or use the existing name.

    Note

    Each environment name must be unique. To overwrite an environment with the same name, select the Overwrite existing environment checkbox.

  8. Click Import.

Your newly imported environment appears in the environments list.

Backing up an environment#

Backing up your environment to Anaconda Cloud protects it from hard drive failure and machine malfunctions, while local backups are valuable for rolling back conda to a previous state.

Warning

Don’t delete your environment backup when uninstalling and reinstalling Anaconda Distribution or Miniconda. If you do, you will not be able to import your existing environments into your new installation.

Activate the environment you want to back up by selecting it from the environments list. Then follow the instructions below to back up to a local file or to Anaconda Cloud.

  1. At the bottom of the environments list, click Backup.

  2. Select Local drive.

  3. Click Backup.

  4. Enter a descriptive name for your environment’s .yml file.

    Note

    Each environment name must be unique.

  5. Choose a place on your computer to save it.

  6. Click Save.

Note

You need an Anaconda Cloud account to back up your environment to Anaconda Cloud.

  1. At the bottom of the environments list, click Backup.

  2. Select Anaconda Cloud.

  3. Enter a descriptive name for the backup. By default, the environment name and current date is entered as the backup name.

    Note

    Each environment name must be unique. To overwrite an environment with the same name, check Overwrite existing environment.

  4. Click Backup.

Removing an environment#

  1. In the environments list, select the environment you want to remove.

  2. At the bottom of the list, click Remove.

    Note

    Removing an environment in Navigator only removes your local copy. It will not remove or delete environments you have backed up to Anaconda Cloud.

  1. In a browser, open Anaconda Cloud.

  2. Sign in using your email address and password.

  3. From your profile in the top-right corner, navigate to Subscriptions.

  4. Select the Environments page.

  5. Select Delete in the row associated with the environment you want to remove.

    Note

    Removing an environment in Anaconda Cloud only removes it from Anaconda Cloud. It does not affect any local copies.

Advanced environment management#

Navigator provides a convenient graphical interface for managing conda environments, channels, and packages. If you’re comfortable working with Anaconda prompt (or terminal on Linux or macOS), you can access additional, advanced management features. To learn more, see Managing environments in the conda documentation.