> ## 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.

# Protected base installers

export const Comments = ({children}) => {
  return <div class="my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10" data-callout-type="comments">
      <div class="w-4">
        <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" xmlns="http://www.w3.org/2000/svg" class="w-5 h-5" aria-label="Comments">
            <path d="M320 112C434.9 112 528 205.1 528 320C528 434.9 434.9 528 320 528C205.1 528 112 434.9 112 320C112 205.1 205.1 112 320 112zM320 576C461.4 576 576 461.4 576 320C576 178.6 461.4 64 320 64C178.6 64 64 178.6 64 320C64 461.4 178.6 576 320 576zM280 400C266.7 400 256 410.7 256 424C256 437.3 266.7 448 280 448L360 448C373.3 448 384 437.3 384 424C384 410.7 373.3 400 360 400L352 400L352 312C352 298.7 341.3 288 328 288L280 288C266.7 288 256 298.7 256 312C256 325.3 266.7 336 280 336L304 336L304 400L280 400zM320 256C337.7 256 352 241.7 352 224C352 206.3 337.7 192 320 192C302.3 192 288 206.3 288 224C288 241.7 302.3 256 320 256z" />
        </svg>
      </div>
      <div class="text-sm prose min-w-0 w-full">
        {children}
      </div>
    </div>;
};

The protected base installer is available for both Miniconda and Anaconda Distribution and protects your base conda environment from destructive changes. Many users inadvertently break their conda installation by installing all packages directly into the base environment, leading to dependency conflicts that are difficult to resolve without fully uninstalling and reinstalling. The protected base installer solves this by making base read-only and providing a default working environment for everyday use.

## What's different about this installer?

The protected base installer introduces two key changes:

* **Protected base environment**: The base environment is frozen and cannot be modified by `conda install`, `pip install`, or other package manager install commands. This prevents accidental breakage of your conda installation.
* **Default working environment**: Instead of activating `base` by default, the installer creates and activates a working environment, called `python-<VERSION>` (where `<VERSION>` is the installer's default version of Python), for your day-to-day package installations.
* **Different default install directory**: Your install directory is `miniconda3_pbe` instead of `miniconda3`.

<Tip>
  Anaconda strongly recommends creating a separate environment for each project to keep your dependencies isolated and your projects reproducible. For more information, see [Why should I create a new environment](/docs/getting-started/concepts/what-is-an-environment#why-should-i-create-a-new-environment).
</Tip>

## Installing Miniconda with Protected Base Environment

If you do not have a current conda installation and want to try the protected base installer, download the installer for your platform below, then follow the standard Miniconda install instructions as a guide.

<Note>
  In [Anaconda Navigator](/docs/legacy/anaconda-navigator/tutorials/manage-environments), your `base` environment is frozen and cannot be modified.
</Note>

Choose your operating system and preferred installer type below:

<Tabs>
  <Tab title="Windows graphical">
    1. Navigate to [anaconda.com/download](https://www.anaconda.com/download).
    2. Scroll down and click **Download Miniconda**.
    3. Click <Icon icon="arrow-down-to-line" iconType="regular" /> **64-bit Graphical Installer** under Miniconda with Protected Base Environment in Beta Installers.
    4. Continue with the [Miniconda Windows graphical installer](/docs/getting-started/miniconda/install/windows-gui-install) instructions, skipping the download step.
  </Tab>

  <Tab title="Windows CLI">
    <Tabs>
      <Tab title="Command Prompt">
        Open a Command Prompt window and run the following command:

        ```sh theme={null}
        curl https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.7.1.beta0-0-Windows-x86_64.exe --output .\Miniconda3-PBE-26.7.1.beta0-0-Windows-x86_64.exe
        ```
      </Tab>

      <Tab title="PowerShell">
        <Note>
          These commands work best with default PowerShell.
        </Note>

        Open a PowerShell window and run the following command:

        ```powershell theme={null}
        Invoke-WebRequest -Uri "https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.7.1.beta0-0-Windows-x86_64.exe" -OutFile ".\Miniconda3-PBE-26.7.1.beta0-0-Windows-x86_64.exe"
        ```
      </Tab>
    </Tabs>

    Continue with the [Miniconda Windows shell installer](/docs/getting-started/miniconda/install/windows-cli-install) instructions, skipping the download step.
  </Tab>

  <Tab title="macOS graphical">
    1. Navigate to [anaconda.com/download](https://www.anaconda.com/download).
    2. Scroll down and click **Download Miniconda**.
    3. Click <Icon icon="arrow-down-to-line" iconType="regular" /> **64-Bit (Apple silicon) Graphical Installer** under Miniconda with Protected Base Environment in Beta Installers.
    4. Continue with the [Miniconda macOS graphical installer](/docs/getting-started/miniconda/install/mac-gui-install) instructions, skipping the download step.
  </Tab>

  <Tab title="macOS CLI">
    1. Open a terminal and run the following command:

       ```sh theme={null}
       curl -O https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.7.1.beta0-0-MacOSX-arm64.sh
       ```

    2. Continue with the [Miniconda macOS terminal installer](/docs/getting-started/miniconda/install/mac-cli-install) instructions, skipping the download step.
  </Tab>

  <Tab title="Linux CLI">
    1. Open a terminal and run the following command, depending on your architecture:

           <CodeGroup>
             ```sh Linux x86 theme={null}
             curl -O https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.7.1.beta0-0-Linux-x86_64.sh
             ```

             ```sh AWS Graviton2/ARM64 theme={null}
             curl -O https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.7.1.beta0-0-Linux-aarch64.sh
             ```
           </CodeGroup>

    2. Continue with the [Miniconda Linux installer](/docs/getting-started/miniconda/install/linux-install) instructions, skipping the download step.
  </Tab>
</Tabs>

## Installing Anaconda Distribution with the Protected Base Environment

If you do not have a current conda installation and want to try the protected base installer with Anaconda Distribution, download the installer for your platform below, then follow the standard Anaconda Distribution install instructions as a guide.

<Note>
  In [Anaconda Navigator](/docs/legacy/anaconda-navigator/tutorials/manage-environments), your `base` environment is frozen and cannot be modified.
</Note>

Choose your operating system and preferred installer type below:

<Tabs>
  <Tab title="Windows graphical" id="anaconda-windows-graphical">
    1. Navigate to [anaconda.com/download](https://www.anaconda.com/download).
    2. Click **Get Started with Anaconda Distribution** and register with Anaconda.
    3. Click <Icon icon="arrow-down-to-line" iconType="regular" /> **64-bit Graphical Installer** under Anaconda Distribution with Protected Base Environment in Beta Installers.
    4. Continue with the [Anaconda Distribution Windows graphical installer](/docs/getting-started/anaconda/install/windows-gui-install) instructions, skipping the download step.
  </Tab>

  <Tab title="Windows CLI" id="anaconda-windows-cli">
    <Tabs>
      <Tab title="Command Prompt">
        Open a Command Prompt window and run the following command:

        ```sh theme={null}
        curl https://repo.anaconda.com/archive/beta/Anaconda3-PBE-2026.07.beta0-1-Windows-x86_64.exe --output .\Anaconda3-PBE-2026.07.beta0-1-Windows-x86_64.exe
        ```
      </Tab>

      <Tab title="PowerShell">
        <Note>
          These commands work best with default PowerShell.
        </Note>

        Open a PowerShell window and run the following command:

        ```powershell theme={null}
        Invoke-WebRequest -Uri "https://repo.anaconda.com/archive/beta/Anaconda3-PBE-2026.07.beta0-1-Windows-x86_64.exe" -OutFile ".\Anaconda3-PBE-2026.07.beta0-1-Windows-x86_64.exe"
        ```
      </Tab>
    </Tabs>

    Continue with the [Anaconda Distribution Windows shell installer](/docs/getting-started/anaconda/install/windows-cli-install) instructions, skipping the download step.
  </Tab>

  <Tab title="macOS graphical" id="anaconda-macos-graphical">
    1. Navigate to [anaconda.com/download](https://www.anaconda.com/download).
    2. Click **Get Started with Anaconda Distribution** and register with Anaconda.
    3. Click <Icon icon="arrow-down-to-line" iconType="regular" /> **64-Bit (Apple silicon) Graphical Installer** under Anaconda Distribution with Protected Base Environment in Beta Installers.
    4. Continue with the [Anaconda Distribution macOS graphical installer](/docs/getting-started/anaconda/install/mac-gui-install) instructions, skipping the download step.
  </Tab>

  <Tab title="macOS CLI" id="anaconda-macos-cli">
    1. Open a terminal and run the following command:

       ```sh theme={null}
       curl -O https://repo.anaconda.com/archive/beta/Anaconda3-PBE-2026.07.beta0-1-MacOSX-arm64.sh
       ```

    2. Continue with the [Anaconda Distribution macOS terminal installer](/docs/getting-started/anaconda/install/mac-cli-install) instructions, skipping the download step.
  </Tab>

  <Tab title="Linux CLI" id="anaconda-linux-cli">
    1. Open a terminal and run the following command, depending on your architecture:

           <CodeGroup>
             ```sh Linux x86 theme={null}
             curl -O https://repo.anaconda.com/archive/beta/Anaconda3-PBE-2026.07.beta0-1-Linux-x86_64.sh
             ```

             ```sh AWS Graviton2/ARM64 theme={null}
             curl -O https://repo.anaconda.com/archive/beta/Anaconda3-PBE-2026.07.beta0-1-Linux-aarch64.sh
             ```
           </CodeGroup>

    2. Continue with the [Anaconda Distribution Linux installer](/docs/getting-started/anaconda/install/linux-install) instructions, skipping the download step.
  </Tab>
</Tabs>

## Converting an existing installation

If you already have conda installed, you can convert your existing installation to use a protected base environment using the following command:

```sh theme={null}
conda doctor --name base --fix
```

This converts your current installation without requiring a fresh install from the beta installer.

## Managing your protected base environment

Because the base environment is protected, you cannot update conda or install plugins using the standard `conda install` command. Instead, use the `conda self` command to manage packages in the base environment:

### Updating conda in your protected base environment

```sh theme={null}
conda self update
```

### Updating conda and all conda plugins in your protected base environment

```sh theme={null}
conda self update --all
```

### Installing a plugin into your protected base environment

<Warning>
  This is only recommended for conda plugins or other packages that specifically modify conda. For more information on conda plugins, see [Plugins](https://docs.conda.io/projects/conda/en/stable/user-guide/concepts/conda-plugins.html) in the official conda documentation.
</Warning>

<CodeGroup>
  ```sh Command theme={null}
  conda self install <PLUGIN>
  ```

  ```sh Example theme={null}
  conda self install conda-pack
  ```
</CodeGroup>

<Comments>
  Replace \<PLUGIN> with the conda plugin you want to install.
</Comments>

### Removing a plugin from your protected base environment

<CodeGroup>
  ```sh Command theme={null}
  conda self remove <PLUGIN>
  ```

  ```sh Example theme={null}
  conda self remove conda-pack
  ```
</CodeGroup>

<Comments>
  Replace \<PLUGIN> with the conda plugin you want to remove.
</Comments>

### More commands

For a full list of available commands, run:

```sh theme={null}
conda self --help
```

For more information, see the [conda-self documentation](https://github.com/conda/conda-self).

## Override options

<Warning>
  The following options bypass the protected base safeguards and are **not recommended** for regular use. Using them can lead to the same dependency conflicts and broken installations that the protected base feature prevents.
</Warning>

In rare cases where you must modify the base environment directly, the following override flags are available:

### Override for conda

Use `--override-frozen` to bypass the frozen base protection when running conda commands:

```sh theme={null}
conda install --override-frozen <PACKAGE>
```

<Comments>
  Replace \<PACKAGE> with the package you want to install.
</Comments>

### Override for pip and other package managers

Use `--break-system-packages` to allow pip, uv, or other PyPA package managers to install into the protected base:

```sh theme={null}
pip install --break-system-packages <PACKAGE>
```

<Comments>
  Replace \<PACKAGE> with the package you want to install.
</Comments>

## Known limitations

* Some legacy workflows that depend on installing packages directly into base might require adjustment.
* Third-party tools that assume write access to the base environment might not work without using override flags.

## Feedback and support

We want to hear about your experience with the protected base installer:

* **General feedback**: Submit feedback through the [Community Forum](https://forum.anaconda.com/c/product-help/anaconda-miniconda/13) or contact [Anaconda Support](https://support.anaconda.com/).
* **conda-self issues**: Report bugs or feature requests for the `conda self` command at [github.com/conda/conda-self](https://github.com/conda/conda-self).