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

# macOS graphical installer

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 BeginnerGlasses = () => {
  return <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" xmlns="http://www.w3.org/2000/svg" aria-label="Beginner">
      <path d="M175.3 160C161.3 160 148.8 169.2 144.7 182.6L102.4 320L256 320C273.7 320 288 334.3 288 352L352 352C352 334.3 366.3 320 384 320L537.6 320L495.3 182.6C491.2 169.2 478.8 160 464.7 160L432 160C414.3 160 400 145.7 400 128C400 110.3 414.3 96 432 96L464.7 96C506.8 96 544.1 123.5 556.5 163.8L601.9 311.3C606 324.5 608 338.2 608 352L608 448C608 501 565 544 512 544L448 544C395 544 352 501 352 448L352 416L288 416L288 448C288 501 245 544 192 544L128 544C75 544 32 501 32 448L32 352C32 338.2 34.1 324.5 38.1 311.3L83.5 163.8C95.9 123.5 133.1 96 175.3 96L208 96C225.7 96 240 110.3 240 128C240 145.7 225.7 160 208 160L175.3 160zM96 384L96 448C96 465.7 110.3 480 128 480L192 480C209.7 480 224 465.7 224 448L224 384L96 384zM512 480C529.7 480 544 465.7 544 448L544 384L416 384L416 448C416 465.7 430.3 480 448 480L512 480z" />
    </svg>;
};

<Accordion title="Using Miniconda in a commercial setting?">
  * You might need to purchase a license to stay compliant with our [Terms of Service](https://www.anaconda.com/legal).

  * If your company security policies do not allow admin privileges for end users, you will be unable to install Miniconda manually. Consider requesting that your IT admin add Miniconda to a software delivery or fleet management system (such as Kandji or Jamf).
</Accordion>

This page provides instructions for installing Miniconda on macOS with a graphical installer.

## Installation steps

<Warning>
  The graphical installer for macOS installs Miniconda into `/opt/miniconda3` in your file system. If you want to install Miniconda into your Home directory or if you have multiple users on a system and want to manage your installation more carefully, Anaconda recommends the [command-line installer](/docs/getting-started/miniconda/install/mac-cli-install).
</Warning>

1. Navigate to [anaconda.com/download](https://www.anaconda.com/download), register with Anaconda, and then select <Icon icon="arrow-down-to-line" iconType="regular" /> **64-bit (Apple silicon) Graphical Installer** under Miniconda.

   <Note>
     As of August 15, 2025, Anaconda has stopped building packages for Intel Mac computers (osx-64). Existing Intel (`MacOSX-x86_64`) installers are still available at [https://repo.anaconda.com/miniconda/](https://repo.anaconda.com/miniconda/). The last Miniconda installer release for Intel Mac computers will be 25.7.x. For more information, see [our blog on the end of Intel mac support](https://www.anaconda.com/blog/intel-mac-package-support-deprecation).
   </Note>

2. Double-click the `.pkg` file.

3. View the Read Me instructions and select **Continue**.

4. Read through [Miniconda's End User License Agreement (EULA)](https://www.anaconda.com/legal/terms/miniconda) and select **Continue**, then select **Agree** to agree to the terms. You can view Anaconda's Terms of Service (TOS) at [https://www.anaconda.com/legal](https://www.anaconda.com/legal).

5. Choose an install location:

   <DefinitionList>
     <DefinitionTerm>
       Install for all users of this computer (Recommended)
     </DefinitionTerm>

     <DefinitionDescription>
       Installs Miniconda into `/opt/miniconda3` for all users of the computer.
     </DefinitionDescription>

     <DefinitionTerm>
       Install on a specific disk
     </DefinitionTerm>

     <DefinitionDescription>
       Enables you to choose a different location to install Miniconda.
     </DefinitionDescription>
   </DefinitionList>

6. Select **Install**. When the installation finishes, open your terminal application.

   <Note>
     You should see `(base)` in the command line prompt. This tells you that you're in your base conda environment. To learn more about environments, see [Environments](/docs/getting-started/working-with-conda/environments).
   </Note>

## Verify your install

Verify your installation by opening your terminal application and running `conda list`. If conda has been installed correctly, a list of installed packages appears:

<CodeGroup>
  ```sh Command theme={null}
  conda list
  ```

  ```sh Example output theme={null}
  # packages in environment at /opt/miniconda3:
  #
  # Name                    Version                   Build  Channel
  ca-certificates           2024.9.24            h06a4308_0  
  certifi                   2024.8.30       py312h06a4308_0  
  conda                     24.9.2          py312h06a4308_0  
  openssl                   3.0.15               h5eee18b_0  
  python                    3.12.7               h5148396_1  
  ...
  ```
</CodeGroup>

## Choose how you want to work with conda

Anaconda Navigator provides a graphical user interface (GUI) to interface with <Tooltip tip="An open-source package and environment manager that installs, updates, and removes packages with their dependencies in isolated environments, allowing multiple versions of the same software without conflicts.">conda</Tooltip>, without using the command line.

If you prefer working at the command line, you can interface with conda directly through [Anaconda Prompt](/docs/reference/glossary#anaconda-prompt) (Windows) or your system's terminal (macOS and Linux) after you complete your installation.

<Note>
  Anaconda Navigator is not included with Miniconda. Follow the instructions on [Installing Navigator](/docs/legacy/anaconda-navigator/install) to manually install Navigator onto your computer.
</Note>

<CardGroup cols={2}>
  <Card title="Get started with Navigator" icon="desktop" href="/docs/legacy/anaconda-navigator/getting-started">
    <div style={{ position: "absolute", top: 0, right: 0, padding: "8px" }}>
      <BeginnerGlasses />
    </div>

    <span style={{ display: "block", marginTop: 0, marginBottom: 0 }}>
      Manage packages and environments with a desktop application
    </span>
  </Card>

  <Card title="Work with conda" icon="terminal" href="/docs/getting-started/working-with-conda/main">
    Use command-line tools for package and environment management
  </Card>
</CardGroup>

## Advanced install options

For more advanced installation options, such as installing with silent mode, installing on older operating systems, or installing for multiple users, see [Advanced installation](/docs/getting-started/advanced-install/main).

## Troubleshooting

<Troubleshoot>
  <TroubleshootTitle>
    ### command not found: conda
  </TroubleshootTitle>

  <TroubleshootCause>
    The `command not found: conda` error occurs when your command line interface (CLI) can't find the conda command in order to use it. This might be because:

    * You don't have conda properly initialized.
    * You have set `auto_activate_base` to `false`.
    * You're using a shell that conda doesn't support.
    * Conda is not installed or the install was incomplete or corrupted.

    <Note>
      These issues primarily occur on macOS/Linux computers. Anaconda Distribution and Miniconda installations on Windows include [Anaconda Prompt](/docs/reference/glossary#anaconda-prompt), which opens with conda initialized by default.
    </Note>
  </TroubleshootCause>

  <TroubleshootSolution>
    <AccordionGroup>
      <Accordion title="Initialize conda in your shell">
        If you recently installed Anaconda Distribution or Miniconda, make sure you closed and reopened your CLI to make conda's initialization take effect.

        <Tip>
          If you don't want to close your CLI, you can also use one of the following `source` commands to refresh your shell:

          <CodeGroup>
            ```sh bash theme={null}
            source ~/.bashrc
            ```

            ```sh zsh theme={null}
            source ~/.zshrc
            ```

            ```sh fish theme={null}
            source ~/.config/fish/config.fish
            ```

            ```sh cshrc theme={null}
            source ~/.cshrc
            ```

            ```sh xonshrc theme={null}
            source ~/.xonshrc
            ```
          </CodeGroup>

          <Comments>
            Use the command that matches your shell.
          </Comments>
        </Tip>

        You can also initialize conda directly from its `bin` directory:

        <CodeGroup>
          ```sh Initialization command theme={null}
          <PATH_TO_CONDA>/bin/conda init
          ```

          ```sh Examples theme={null}
          miniconda3/bin/conda init
          /opt/miniconda3/bin/conda init
          anaconda3/bin/conda init
          /opt/anaconda3/bin/conda init
          ```
        </CodeGroup>

        <Comments>
          Replace \<PATH\_TO\_CONDA> with a path to your conda installation.
        </Comments>
      </Accordion>

      <Accordion title="Set auto_activate_base to true">
        To see the value for `auto_activate_base`, run the following command:

        ```sh theme={null}
        conda config --describe auto_activate_base
        ```

        If your terminal returns `false`, this means that conda is not automatically activating your base environment when you start a new shell. This behavior emulates your system Python, and some users prefer to have their conda environment be inactive until they need it. However, this is not conda's default behavior after installation.

        To change the value of `auto_activate_base` to `true`, run the following command:

        ```sh theme={null}
        conda config --set auto_activate_base true
        ```

        If you have `auto_activate_base` set as `false`, the conda command will still be available as a shell function, but your base environment will not be active when a new shell is started. To activate your base environment, run `conda activate`.
      </Accordion>

      <Accordion title="Use a shell that conda supports">
        For information on which shells conda supports, see [Conda activate](https://docs.conda.io/projects/conda/en/stable/dev-guide/deep-dives/activation.html#conda-activate) in the official conda documentation.
      </Accordion>

      <Accordion title="Verify your installation of conda">
        If you have tried to initialize conda in your shell but it didn't work, try uninstalling and reinstalling [Anaconda Distribution](/docs/getting-started/installation) or [Miniconda](/docs/getting-started/installation).

        <Tip>
          Make sure that you say yes to the initialization option, and, if installing from the CLI, reinitialize your shell by restarting it or using its `source` command. For more information, see [Initialize conda in your shell](#initialize-conda-in-your-shell).
        </Tip>
      </Accordion>
    </AccordionGroup>
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Error message on install: Already installed
  </TroubleshootTitle>

  <TroubleshootCause>
    This situation can occur if you are getting a conda error and you want to reinstall Miniconda to fix it.
  </TroubleshootCause>

  <TroubleshootSolution>
    <Note>
      These instructions are for macOS and Linux.
    </Note>

    1. [Download the latest Miniconda installer for your operating system](https://anaconda.com/download).
    2. Install Miniconda with the `--force` or `-f` option by running the following command:

    ```sh theme={null}
    bash ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh -f
    ```

    <Comments>
      Replace the name of the installer if you need a different version or operating system.
    </Comments>

    <Warning>
      Make sure to install to the same location as your existing install so it overwrites the core conda files and does not install duplicates in a new folder.
    </Warning>
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    <h3 id="this-package-is-incompatible-with-this-version-of-macos-error-when-running-a-pkg-installer-on-osx">
      This package is incompatible with this version of macOS error when running a .pkg installer on OSX
    </h3>
  </TroubleshootTitle>

  <TroubleshootCause>
    When running the `.pkg` installer, you may encounter this error during the "Installation" step:<br />

    <Frame>
      <img src="https://mintcdn.com/anaconda-29683c67/YGtija9HXl-k020Y/images/anaconda_pkg_incompatible_error_1.png?fit=max&auto=format&n=YGtija9HXl-k020Y&q=85&s=9110e32ce6c4ac8373415db81a08af20" alt="" width="1242" height="892" data-path="images/anaconda_pkg_incompatible_error_1.png" />
    </Frame>

    <br />

    This error occurs when the installation attempts to write to a directory for which it does not have write permissions.
  </TroubleshootCause>

  <TroubleshootSolution>
    Manually select an appropriate install location. The following example shows how to select your user's home directory.

    1. Re-run the installer and click through until you reach either the Installation Type or Destination Select page.

    2. If you reach the Installation Type page first, click **Change Install Location…**. This will take you to the Destination Select page.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/YGtija9HXl-k020Y/images/anaconda_pkg_incompatible_error_2.png?fit=max&auto=format&n=YGtija9HXl-k020Y&q=85&s=16da66d0ba347ad75f65b43fe3fedd70" alt="" width="1250" height="892" data-path="images/anaconda_pkg_incompatible_error_2.png" />
           </Frame>

    3. Click **Install on a specific disk…**.

    4. Click the appropriate destination drive. Then click **Choose Folder…**.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/YGtija9HXl-k020Y/images/anaconda_pkg_incompatible_error_3.png?fit=max&auto=format&n=YGtija9HXl-k020Y&q=85&s=9b258d8d3d6218b792ed0e337619ddfd" alt="" width="1250" height="892" data-path="images/anaconda_pkg_incompatible_error_3.png" />
           </Frame>

    5. Click your user's home directory (for example, /Users/john.doe/). Then, click **Choose**.

    6. In the message box, confirm the name of the install folder you chose in the previous step. Then click **Continue**.

           <Frame>
             <img src="https://mintcdn.com/anaconda-29683c67/YGtija9HXl-k020Y/images/anaconda_pkg_incompatible_error_4.png?fit=max&auto=format&n=YGtija9HXl-k020Y&q=85&s=355ba3f7018ce7b72397a455a4e3d0b6" alt="" width="1250" height="892" data-path="images/anaconda_pkg_incompatible_error_4.png" />
           </Frame>

    7. Click **Install**, and then proceed with the rest of the installation.

    If you continue to receive the same error message, please open an issue [here](https://github.com/ContinuumIO/anaconda-issues/issues/new/choose/), and be sure to include the installation log output from your `install.log` file, which can be found at `/var/log/install.log`.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Recovering your Miniconda installation
  </TroubleshootTitle>

  <TroubleshootCause>
    If your Miniconda installation has become corrupted and is in a state where normal conda commands are not functioning, use the following steps to repair your installation and preserve your installed packages and environments.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. Download a [new installer](https://repo.anaconda.com/miniconda/) for your operating system.

           <Tabs>
             <Tab title="Windows">
               1. Open a terminal application, such as Command Prompt or PowerShell.
               2. If necessary, navigate to the parent directory of your Miniconda installation (by default, this is your user profile).
               3. Rename your existing installation directory so you do not overwrite it:

                          <CodeGroup>
                            ```sh Command Prompt theme={null}
                            move miniconda3 miniconda_old
                            ```

                            ```powershell PowerShell theme={null}
                            Move-Item miniconda3 miniconda_old
                            ```
                          </CodeGroup>
               4. Run the new Miniconda installer. When prompted for an install location, choose the same directory as your original installation.
               5. Copy your previous packages and environments to the new installation:

                  ```sh theme={null}
                  robocopy miniconda_old miniconda3 /S
                  ```
               6. Delete your old Miniconda installation directory:

                          <CodeGroup>
                            ```sh Command Prompt theme={null}
                            rd /s /q miniconda_old
                            ```

                            ```powershell PowerShell theme={null}
                            Remove-Item -Recurse -Force miniconda_old
                            ```
                          </CodeGroup>
             </Tab>

             <Tab title="macOS/Linux">
               1. Open a terminal application.
               2. If necessary, navigate to the parent directory of your Miniconda installation (by default, this is your home directory).
               3. Rename your existing installation directory so you do not overwrite it:

                  ```sh theme={null}
                  mv miniconda3 miniconda_old
                  ```
               4. Run the new Miniconda installer. When prompted for an install location, choose the same directory as your original installation:

                  ```sh theme={null}
                  bash ~/Downloads/Miniconda3-latest-Linux-x86_64.sh
                  ```
               5. Copy your previous packages and environments to the new installation:

                  ```sh theme={null}
                  rsync -a miniconda_old/ miniconda3/
                  ```
               6. Delete your old Miniconda installation directory:

                  ```sh theme={null}
                  rm -rf miniconda_old
                  ```
             </Tab>
           </Tabs>

    2. Run `conda list` to view the packages from the previous installation.

    3. Run `conda info --envs` to list the environments created in the previous installation, which are now available in the new installation.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Proxy request sent, not found
  </TroubleshootTitle>

  <TroubleshootCause>
    Your company likely has security policies or a firewall in place that prevent communications with external servers or certain URLs.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. First, work with your IT team to allowlist connections to the following URLs:

       ```txt theme={null}
       https://anaconda.org
       https://repo.anaconda.com
       https://repo.anaconda.cloud
       ```

           <Note>
             Allowlisting `https://repo.anaconda.cloud` is only necessary if your company has an Anaconda Platform organization and you require access to channels in that organization.
           </Note>

    2. [Install](/docs/getting-started/main) Anaconda Distribution or Miniconda again.

    Once your installation is complete, you might also need to connect your company's firewall/proxy server to your conda configuration file (`.condarc`). For more information on this, see [Using Anaconda behind a firewall or proxy](/docs/anaconda-platform/getting-started-with-anaconda-platform#using-anaconda-behind-a-firewall-or-proxy-optional).
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### macOS installation failure - x86\_64 (Intel chip)
  </TroubleshootTitle>

  <TroubleshootCause>
    Anaconda no longer supports Anaconda Distribution and Miniconda installers for Intel chip macOS computers (osx-64) and has removed these installers from the Anaconda.com website. If you downloaded a macOS installer from the website and your installation is failing, it is possible that you have an Intel chip macOS computer and the installer on the website is not compatible with your computer.
  </TroubleshootCause>

  <TroubleshootSolution>
    To check what architecture your macOS computer has:

    1. Select the <Icon icon="apple" /> **Apple** icon on your title bar.
    2. Select **About This Mac**.
    3. A macOS computer with an Intel chip will have "Intel" in the **Processor** item, while a macOS computer with an Apple silicon chip will have a **Chip** item labeled "Apple M1" or similar.

    macOS computers with Intel chip architecture use installers labeled `MacOSX-x86_64`, while macOS computers with Apple silicon chips use installers labeled `MacOSX-arm64`. While Anaconda no longer provides `MacOSX-x86_64` installers on its website, you can still find them in our installer archives.

    * [Anaconda Distribution installer archive](https://repo.anaconda.com/archive)
    * [Miniconda installer archive](https://repo.anaconda.com/miniconda)
  </TroubleshootSolution>
</Troubleshoot>