=====================
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 a command prompt or terminal window, you can access additional, 
advanced management features. To learn more, see 
`Managing environments <https://conda.io/docs/using/envs.html>`_ with conda.
