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

# Installing the anaconda metapackage

export const TroubleshootSolution = ({children}) => <>
    <hr className="my-3 w-full" />
    <details className="mt-3">
      <summary className="cursor-pointer font-semibold text-base mb-1">
        Solution
      </summary>
      <div className="mt-2 ml-4" data-component-part="step-content">
        {children}
      </div>
    </details>
  </>;

export const TroubleshootCause = ({children}) => <details className="mt-3 mb-2">
    <summary className="cursor-pointer font-semibold text-base mb-1">
      Cause
    </summary>
    <div className="mt-2 ml-4" data-component-part="step-content">
      {children}
    </div>
  </details>;

export const TroubleshootTitle = ({children}) => <>
    <p className="m-0 font-semibold text-xl leading-tight mb-2" role="heading" aria-level={3}>
      {children}
    </p>
    <hr className="my-3 w-full" />
  </>;

export const Troubleshoot = ({children}) => <div className="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border troubleshoot-admonition dark:troubleshoot-admonition" data-callout-type="troubleshoot">
    <div className="mt-0.5 w-4">
      <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" className="w-4 h-4" aria-label="Troubleshoot">
        <path d="M541.4 162.6C549 155 561.7 156.9 565.5 166.9C572.3 184.6 576 203.9 576 224C576 312.4 504.4 384 416 384C398.5 384 381.6 381.2 365.8 376L178.9 562.9C150.8 591 105.2 591 77.1 562.9C49 534.8 49 489.2 77.1 461.1L264 274.2C258.8 258.4 256 241.6 256 224C256 135.6 327.6 64 416 64C436.1 64 455.4 67.7 473.1 74.5C483.1 78.3 484.9 91 477.4 98.6L388.7 187.3C385.7 190.3 384 194.4 384 198.6L384 240C384 248.8 391.2 256 400 256L441.4 256C445.6 256 449.7 254.3 452.7 251.3L541.4 162.6z" />
      </svg>
    </div>
    <div className="prose min-w-0 w-full">{children}</div>
  </div>;

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 `anaconda` metapackage is a version-locked collection of packages that were included in an Anaconda Distribution installer. Version-locked packages (also called pinned packages) are tied to a specific version of their software. Conda does not update pinned packages when resolving dependencies if other packages in the environment are added or modified. Because each package in the metapackage is pinned, *any attempt to update the environment will almost certainly result in build conflicts*.

However, it is still possible to install the `anaconda` metapackage and update the environment that contains it. For more information, see [Updating a metapackage environment](#updating-a-metapackage-environment).

<Note>
  The `anaconda` metapackage was removed from Anaconda Distribution installers in February of 2023 and no longer appears in your `base` environment by default.
</Note>

## Installing the metapackage

If you plan to install the `anaconda` metapackage, Anaconda recommends that you create an environment specifically for that metapackage first:

1. Open Anaconda Prompt (Terminal on macOS/Linux).

2. Create a new environment by running the following command:

   ```sh theme={null}
   conda create --name <ENV>
   ```

   <Comments>
     Replace \<ENV> with the name of your environment.
   </Comments>

3. (Optional) Search for metapackage versions available for install by running the following command:

   ```sh theme={null}
   conda search anaconda
   ```

4. Install the `anaconda` metapackage or specify a metapackage version by running one of the following commands:

   <Tabs>
     <Tab title="Latest version">
       ```sh theme={null}
       conda install anaconda
       ```
     </Tab>

     <Tab title="Specific version">
       ```sh theme={null}
       conda install anaconda=<VERSION>
       ```

       <Comments>
         Replace \<VERSION> with the specific version you want to install.
       </Comments>
     </Tab>
   </Tabs>

## Updating a metapackage environment

If you have an environment containing the `anaconda` metapackage and need to update packages in that environment, you must first unpin the package versions in your environment. This is accomplished by installing the `anaconda=custom` version of the metapackage:

1. Open Anaconda Prompt (Terminal on macOS/Linux).

2. Open the environment containing the metapackage you want to update:

   ```sh theme={null}
   conda activate <ENV>
   ```

   <Comments>
     Replace \<ENV> with the name of your metapackage environment.
   </Comments>

3. Install the custom version of the `anaconda` package using the following command:

   ```sh theme={null}
   conda install anaconda=custom
   ```

4. Install or update packages as necessary.

   For more information on managing packages, see [Managing packages](https://docs.conda.io/projects/conda/en/stable/user-guide/tasks/manage-pkgs.html) in the conda documentation.

<Troubleshoot>
  <TroubleshootTitle>
    ### `conda update anaconda` command does not install the latest version of the `anaconda` metapackage
  </TroubleshootTitle>

  <TroubleshootCause>
    <Note>
      The `anaconda` metapackage was removed from Anaconda Distribution installers in February of 2023 and no longer appears in your `base` environment by default. This troubleshooting topic assumes you are working with package incompatibilities in an environment containing the `anaconda` metapackage.
    </Note>

    If you have installed packages that are incompatible with the latest version of the Anaconda metapackage, running `conda update anaconda` updates the Anaconda metapackage to the latest compatible version. Keep in mind this might not be the latest version.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. Obtain a list of the conflicting packages by running `conda update anaconda` or `conda install anaconda=2023.07`.

           <Note>
             Replace `2023.07` with the latest version number.
           </Note>

    2. Enter `n` to cancel the installation or update.

    3. Once you know which packages are conflicting, you can:
       * update all current packages without upgrading to the latest version of the `anaconda` metapackage, or
       * remove the conflicting packages and then upgrade to the latest version of the `anaconda` metapackage.

    To update all current packages without upgrading to the latest version of the `anaconda` metapackage:

    1. Remove the `anaconda` metapackage itself by running the following command:

       ```sh theme={null}
       conda remove anaconda
       ```
    2. Update all currently installed packages by running the following command:

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

    To remove the conflicting packages and upgrade to the latest version of the `anaconda` metapackage:

    1. Remove the conflicting packages by running the following command for each one:

       ```sh theme={null}
       conda remove <PACKAGE>
       ```
    2. Update to the latest version of the `anaconda` metapackage:

       ```sh theme={null}
       conda update anaconda
       ```
  </TroubleshootSolution>
</Troubleshoot>