=====================
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 (Terminal on Linux or macOS), you can access additional, 
advanced management features. To learn more, see
`Managing environments <https://conda.io/docs/using/envs.html>`_ with conda.
