=====================
Managing environments
=====================

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

On the **Environments** tab, the left column displays your environments.

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

   ..

|

Searching for an environment
============================

In the Search Environments box, type all or part of the environment name.

.. _navigator-create-environment:

Creating a new environment
==========================

#. At the bottom of the environments list, click the Create button.
#. In the Create Environment dialog box, type a descriptive name for the
   new environment.
#. Select Python, R or both for a mixed environment.
#. If applicable, choose a Python version for the new environment.
#. Click the Create button.

When you install an R language environment, the https://anaconda.org/r
channel is automatically added and made active, and a new channel
automatically appears in condarc.

Using an environment
====================

#. In the environments list, click the environment name.
#. Click the arrow button next to the name. The activation options
   dialog appears.
#. 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
======================

#. Click the name of the environment you want to clone.
#. At the bottom of the environments list, click the Clone button.
#. Type a descriptive name for the new environment.

.. _navigator-import-environment:

Importing an environment
========================

Each environment has a YAML-formatted configuration file. If someone has
given you an environment file that you want to use, for example
my-environment-file.yml, and you have saved it to your computer, you can
import it into Navigator.

#. At the bottom of the environments list, click the Import button.
#. In the Import dialog box, type a descriptive name for the new environment.
#. Click the file folder icon to browse to the YAML file, or type the
   file name, including its path.
#. Click the Import button.

Removing an environment
=======================

#. In the environments list, click the environment you want to remove.

#. At the bottom of the list, click the Remove button.

Advanced environment management
===============================

Navigator provides a convenient graphical interface for managing conda
environments, channels and packages. But if you're comfortable working
with Anaconda Prompt or a terminal window, you can access additional, 
advanced management features. To learn more, see
`Managing environments <https://conda.io/docs/using/envs.html>`_ with conda.
