> ## 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 The protected base installer protects your base conda environment from destructive changes, and is available for both Miniconda and Anaconda Distribution. 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-` (where `` 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](https://anaconda.com/docs/getting-started/concepts/what-is-an-environment.md#why-should-i-create-a-new-environment). ## 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](https://anaconda.com/docs/legacy/anaconda-navigator/tutorials/manage-environments.md), your `base` environment is frozen and cannot be modified. Choose your operating system and preferred installer type below: > [tab] Windows graphical > > > [tab] EXE installer > > > > 1. Navigate to [anaconda.com/download](https://www.anaconda.com/download). > > > > 2. Scroll down and click **Download Miniconda**. > > > > 3. Select one of the following EXE installers under Miniconda with Protected Base Environment in Beta Installers: > > > > * **64-bit (x86\_64) Graphical Installer**: For standard Windows PCs with Intel or AMD processors. Choose this if you are unsure which installer to use. > > * **64-bit (Arm64) Graphical Installer**: For Windows PCs with Arm-based processors, such as devices with Qualcomm Snapdragon X chips or other Windows on Arm hardware. > > > > 4. Continue with the [Miniconda Windows graphical installer](https://anaconda.com/docs/getting-started/miniconda/install/windows-gui-install.md) instructions, skipping the download step. > > > [tab] MSI installer > > > > Follow the [MSI graphical installer](https://anaconda.com/docs/getting-started/msi-installer-beta/install/windows-gui-install.md) instructions. > [tab] Windows CLI > > > [tab] EXE installer > > > > > [tab] Command Prompt > > > > > > Open a Command Prompt window and run the following command: > > > > > > ```sh x86_64 theme={null} > > > curl https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.9.4.beta1-Windows-x86_64.exe --output .\Miniconda3-PBE-26.9.4.beta1-Windows-x86_64.exe > > > ``` > > > > > > ```sh Arm64 theme={null} > > > curl https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.9.4.beta1-Windows-arm64.exe --output .\Miniconda3-PBE-26.9.4.beta1-Windows-arm64.exe > > > ``` > > > > > [tab] PowerShell > > > > > > > [!NOTE] > > > > > > > > These commands work best with default PowerShell. > > > > > > Open a PowerShell window and run the following command: > > > > > > ```powershell x86_64 theme={null} > > > Invoke-WebRequest -Uri "https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.9.4.beta1-Windows-x86_64.exe" -OutFile ".\Miniconda3-PBE-26.9.4.beta1-Windows-x86_64.exe" > > > ``` > > > > > > ```powershell Arm64 theme={null} > > > Invoke-WebRequest -Uri "https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.9.4.beta1-Windows-arm64.exe" -OutFile ".\Miniconda3-PBE-26.9.4.beta1-Windows-arm64.exe" > > > ``` > > > > Continue with the [Miniconda Windows shell installer](https://anaconda.com/docs/getting-started/miniconda/install/windows-cli-install.md) instructions, skipping the download step. > > > [tab] MSI installer > > > > Follow the [MSI shell installer](https://anaconda.com/docs/getting-started/msi-installer-beta/install/windows-cli-install.md) instructions. For silent installation, see [Silent installation](https://anaconda.com/docs/getting-started/msi-installer-beta/install/silent-install.md). > [tab] macOS graphical > > 1. Navigate to [anaconda.com/download](https://www.anaconda.com/download). > 2. Scroll down and click **Download Miniconda**. > 3. Click **64-Bit (Apple silicon) Graphical Installer** under Miniconda with Protected Base Environment in Beta Installers. > 4. Continue with the [Miniconda macOS graphical installer](https://anaconda.com/docs/getting-started/miniconda/install/mac-gui-install.md) instructions, skipping the download step. > [tab] 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.9.4.beta1-MacOSX-arm64.sh > ``` > > 2. Continue with the [Miniconda macOS terminal installer](https://anaconda.com/docs/getting-started/miniconda/install/mac-cli-install.md) instructions, skipping the download step. > [tab] Linux CLI > > 1. Open a terminal and run the following command, depending on your architecture: > > ```sh Linux x86 theme={null} > curl -O https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.9.4.beta1-Linux-x86_64.sh > ``` > > ```sh AWS Graviton2/ARM64 theme={null} > curl -O https://repo.anaconda.com/miniconda/beta/Miniconda3-PBE-26.9.4.beta1-Linux-aarch64.sh > ``` > > 2. Continue with the [Miniconda Linux installer](https://anaconda.com/docs/getting-started/miniconda/install/linux-install.md) instructions, skipping the download step. ## 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](https://anaconda.com/docs/legacy/anaconda-navigator/tutorials/manage-environments.md), your `base` environment is frozen and cannot be modified. Choose your operating system and preferred installer type below: > [tab] 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 **64-bit Graphical Installer** under Anaconda Distribution with Protected Base Environment in Beta Installers. > 4. Continue with the [Anaconda Distribution Windows graphical installer](https://anaconda.com/docs/getting-started/anaconda/install/windows-gui-install.md) instructions, skipping the download step. > [tab] Windows CLI > > > [tab] 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] PowerShell > > > > > [!NOTE] > > > > > > These commands work best with default PowerShell. > > > > 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" > > ``` > > Continue with the [Anaconda Distribution Windows shell installer](https://anaconda.com/docs/getting-started/anaconda/install/windows-cli-install.md) instructions, skipping the download step. > [tab] 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 **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](https://anaconda.com/docs/getting-started/anaconda/install/mac-gui-install.md) instructions, skipping the download step. > [tab] 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](https://anaconda.com/docs/getting-started/anaconda/install/mac-cli-install.md) instructions, skipping the download step. > [tab] Linux CLI > > 1. Open a terminal and run the following command, depending on your architecture: > > ```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 > ``` > > 2. Continue with the [Anaconda Distribution Linux installer](https://anaconda.com/docs/getting-started/anaconda/install/linux-install.md) instructions, skipping the download step. ## 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. ```sh Command theme={null} conda self install ``` ```sh Example theme={null} conda self install conda-pack ``` Comments Replace \ with the conda plugin you want to install. ### Removing a plugin from your protected base environment ```sh Command theme={null} conda self remove ``` ```sh Example theme={null} conda self remove conda-pack ``` Comments Replace \ with the conda plugin you want to remove. ### 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. 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 ``` Comments Replace \ with the package you want to install. ### 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 ``` Comments Replace \ with the package you want to install. ## 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).