> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing environments

export const Danger = ({children}) => {
  return <div class="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border danger-admonition dark:danger-admonition" data-callout-type="danger">
      <div class="mt-0.5 w-4">
        <svg width="14" height="14" viewBox="0 0 14 14" fill="rgb(239, 68, 68)" xmlns="http://www.w3.org/2000/svg" class="w-4 h-4 text-sky-500" aria-label="Danger">
          <path fill-rule="evenodd" clip-rule="evenodd" d="M7 1.3C10.14 1.3 12.7 3.86 12.7 7C12.7 10.14 10.14 12.7 7 12.7C5.48908 12.6974 4.0408 12.096 2.97241 11.0276C1.90403 9.9592 1.30264 8.51092 1.3 7C1.3 3.86 3.86 1.3 7 1.3ZM7 0C3.14 0 0 3.14 0 7C0 10.86 3.14 14 7 14C10.86 14 14 10.86 14 7C14 3.14 10.86 0 7 0ZM8 3H6V8H8V3ZM8 9H6V11H8V9Z"></path>
        </svg>
      </div>
      <div class="text-sm prose min-w-0 w-full">
        {children}
      </div>
    </div>;
};

## Viewing environments

To view your <Tooltip tip="A self-contained, isolated space for installing and running software packages.">environments</Tooltip>, select <Icon icon="cube" iconType="sharp-regular" /> **Environments** from the left-hand navigation.

<Frame>
  <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-labeled.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=4377b5c3597b0f1a89e1fc2bf8af3ca0" alt="environments page button" width="1922" height="676" data-path="images/nav-env-labeled.png" />
</Frame>

<Tip>
  You can collapse and expand the environments list by clicking on the <Icon icon="chevron-left" iconType="regular" aria-label="collapse" /> or <Icon icon="chevron-right" iconType="regular" aria-label="expand" /> icon beside the environments list.
</Tip>

## Searching for an environment

Use the **Search Environments** box to locate an environment by name. Enter all (or part of) an environment's name to filter the list to display only environments that contain the <Tooltip tip="A sequence of characters, like letters, numbers, and spaces.">search string</Tooltip>.

<Frame>
  <img src="https://mintcdn.com/anaconda-29683c67/eSsEBS6xLmJK8V-1/images/nav-env-search.png?fit=max&auto=format&n=eSsEBS6xLmJK8V-1&q=85&s=86f47395e855cd61521f2b8cfda7265d" alt="filtering environments using search" width="1922" height="676" data-path="images/nav-env-search.png" />
</Frame>

## Managing environments

Anaconda Navigator provides a set of buttons at the bottom of the environments list to help you manage environments.

<Frame>
  <img src="https://mintcdn.com/anaconda-29683c67/eSsEBS6xLmJK8V-1/images/nav-env-buttons.png?fit=max&auto=format&n=eSsEBS6xLmJK8V-1&q=85&s=9e929ed1c1ca495ce56bd90577033ed5" alt="environment management buttons" width="1922" height="676" data-path="images/nav-env-buttons.png" />
</Frame>

### Creating a new environment

1. Click <Icon icon="square-plus" iconType="solid" /> **Create** at the bottom of the environments list.

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

   <Frame>
     <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-create.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=b483dda704776adb4c01aa2dcd7cc3f6" alt="create new environment button and dialog" width="1922" height="676" data-path="images/nav-env-create.png" />
   </Frame>

   <Tip>
     The location where your new environment will be created displays below the New environment name box as it is being entered.
   </Tip>

3. Select either **Python** or **R** as the language <Tooltip tip="The software that runs your code.">interpreter</Tooltip> for your environment.

   <Accordion title="Why do I need to pick a Python or R version?">
     Conda packages are built for a specific language <Tooltip tip="The interpreter and other behind-the-scenes systems that run your code.">runtime</Tooltip>. Choosing Python or R adds the matching interpreter to the environment so packages you install and code you write operate correctly.
   </Accordion>

4. Open the dropdown and select a version for your interpreter.

5. Click **Create**.

### Activating and using an environment

1. Click on an environment in the list to activate it.
2. Click the <Icon icon="circle-play" iconType="solid" /> button beside the environment's name to open the activation options dropdown.

   <Frame>
     <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-use.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=37bcfa81396b7fc62162831e010aaf0f" alt="environment use options" width="1922" height="676" data-path="images/nav-env-use.png" />
   </Frame>

   Some activation options require additional packages to be installed in the environment.

   | Option                 | Description                                                                                                                                   | Required packages |
   | :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- |
   | **Terminal**           | Opens a shell session (`bash`, `cmd`, or PowerShell, depending on OS) with the environment activated. Use it for CLI tools or shell commands. | None              |
   | **Python interpreter** | Launches the standard `python` REPL inside the environment. Useful for quick checks or running scripts.                                       | None              |
   | **IPython Console**    | Starts an enhanced interactive Python shell.                                                                                                  | `ipython`         |
   | **Jupyter Notebook**   | Opens Jupyter Notebook in your default browser, letting you create and run notebook files.                                                    | `notebook`        |

### Cloning an environment

<Warning>
  Anaconda strongly recommends *against* cloning the `base` environment because the process can generate an incomplete clone of the environment, which could cause errors while using Navigator or conda. For these reasons, Anaconda Navigator does not allow you to clone your base environment.
</Warning>

1. Activate the environment you want to clone by selecting it from the environments list.
2. Click <Icon icon="clone" iconType="sharp-solid" /> **Clone** at the bottom of the environments list.
3. Enter a descriptive name for the new environment.
4. Click **Clone**.

<Frame>
  <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-clone.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=31eaa8f8256da30d30fe66a2c4894afb" alt="cloning an environment" width="1922" height="677" data-path="images/nav-env-clone.png" />
</Frame>

### Importing an environment

There are two situations in which you might want to import an environment:

* Someone has [exported their environment](/getting-started/working-with-conda/environments#exporting-the-environment-configuration-yml-file) to a `environment.yml` file and shared it with you, and you want to reproduce their environment on your machine.
* You have [backed up an environment](#backing-up-an-environment) (either locally or to Anaconda.com), and you want to restore it to the backed up state.

<Tabs>
  <Tab title="Importing from a local .yml file">
    If someone has shared an `environment.yml` file with you, or you have backed up an environment locally:

    1. Save it somewhere on your computer.

    2. Click <Icon icon="file-import" iconType="sharp-solid" /> **Import** at the bottom of the environments list.

    3. Select **Local drive**.

    4. Click the <Icon icon="folder" iconType="solid" /> folder beside **Local drive**.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-import-local.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=2be0d0dc6a32195ed0d9de5e85400285" alt="importing an environment from your local files" width="1922" height="675" data-path="images/nav-env-import-local.png" />
           </Frame>

    5. Browse your local files and select the `.yml` file you want to import.

    6. Enter a new name for the new environment (or use the existing name).

           <Note>
             Environment names must be unique. To overwrite an existing environment with the same name, select the **Overwrite existing environment** checkbox.
           </Note>

    7. Click **Import**.
  </Tab>

  <Tab title="Importing from Anaconda.com">
    1. At the bottom of the environments list, select **Import**.

    2. If necessary, [sign in to Anaconda.com](https://auth.anaconda.com/ui/login?return_to=https://anaconda.com/app/).

    3. Select **Anaconda Cloud**.

    4. Click the <Icon icon="folder" iconType="solid" /> folder in the **Anaconda Cloud** section.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-import-cloud.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=db9aef3876a63a6e790ff630acdf33fa" alt="importing an environment from anaconda.com" width="1922" height="676" data-path="images/nav-env-import-cloud.png" />
           </Frame>

    5. Select the environment you want to import.

           <Tip>
             If you do not want to immediately create a new environment, click <Icon icon="circle-down" iconType="sharp-solid" /> **Download environment file** and save the environment to your computer as a `.yml` file. Click **Cancel** twice to close the Import Environment dialogs when finished.
           </Tip>

    6. Click **Select**.

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

           <Note>
             Each environment name must be unique. If you have an environment with the same name as the one you're importing and want to overwrite it, select the **Overwrite existing environment** checkbox.
           </Note>

    8. Click **Import**.
  </Tab>
</Tabs>

### Backing up an environment

Backing up an environment to Anaconda.com protects it from machine malfunctions, such as hard-drive failure, while local backups are valuable for restoring your environment to a previous working state (in case you encounter a package-dependency issue).

Anaconda Navigator provides two ways to back up an environment:

<Tabs>
  <Tab title="Backing up locally">
    1. Click on an environment in the list to activate it.
    2. Click <Icon icon="upload" iconType="sharp-solid" /> **Backup** at the bottom of the environments list.

    <Frame>
      <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-backup-local.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=dcde13da26bfd33fe3c4cbc459bfbe74" alt="backing up an environment to your local drive" width="1922" height="676" data-path="images/nav-env-backup-local.png" />
    </Frame>

    1. Select **Local drive**.

    2. Click **Save**.

    3. Enter a descriptive name for your backup. By default, backups are named `<ENV_NAME>_YYYYMMDD.yml`.

           <Note>
             Environment names must be unique. To overwrite an existing environment with the same name, select the **Overwrite existing environment** checkbox.
           </Note>

    4. Choose a location on your computer to save the environment backup file.

    5. Click **Save**.
  </Tab>

  <Tab title="Backing up to Anaconda.com">
    <Note>
      Backing up an environment to Anaconda.com requires an [Anaconda.com account](https://auth.anaconda.com/ui/registration?return_to=https://anaconda.com/app/).
    </Note>

    1. Verify that you are signed in to [Anaconda.com](/tools/anaconda-navigator/tutorials/connecting-to-cloud#connecting-anaconda-com-to-navigator).
    2. Click <Icon icon="upload" iconType="sharp-solid" /> **Backup** at the bottom of the environments list.

    <Frame>
      <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-backup-cloud.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=e19d4c0aec0a27fb17e5ede81ede9f50" alt="backing up an environment to Anaconda.com" width="1922" height="676" data-path="images/nav-env-backup-cloud.png" />
    </Frame>

    1. Select **Anaconda Cloud**.

    2. Enter a descriptive name for the backup. By default, backups are named `<ENV_NAME>_YYYYMMDD.yml`.

           <Note>
             Environment names must be unique. To overwrite an existing environment with the same name, select the **Overwrite existing environment** checkbox.
           </Note>

    3. Click **Backup**.
  </Tab>
</Tabs>

### Removing an environment

You can use Navigator to remove environments that are stored locally on your computer. Environments that you have backed up to Anaconda.com must be removed from your Anaconda.com Account Settings.

<Tabs>
  <Tab title="Removing local environments">
    1. Click on an environment in the list to activate it.

    2. Click <Icon icon="trash" iconType="sharp-solid" /> **Remove** at the bottom of the environments list.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/6D31YpqRkubqi7Pk/images/nav-env-remove-local.png?fit=max&auto=format&n=6D31YpqRkubqi7Pk&q=85&s=454344a9c3a2f4c304696350aab16464" alt="removing an environment from your local machine" width="1922" height="676" data-path="images/nav-env-remove-local.png" />
           </Frame>

    3. Click **Remove**.
  </Tab>

  <Tab title="Removing backups from Anaconda.com">
    1. Navigate to your [Account Settings Environments](https://anaconda.com/app/profile/environments) tab.

    2. Click **Delete** beside the environment you want to remove.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/JBF5ENEj_nAQLpgR/images/cloud-env-delete.png?fit=max&auto=format&n=JBF5ENEj_nAQLpgR&q=85&s=3696bfd9139788e41477db49cb286a98" alt="removing an environment from Anaconda.com" width="1922" height="641" data-path="images/cloud-env-delete.png" />
           </Frame>

    3. Click **Delete**.
  </Tab>
</Tabs>
