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

# Linux 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 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>;
};

<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, Jamf, and so on).
</Accordion>

This page provides instructions for installing Miniconda on Linux with the command line in a shell application.

## Installation steps

1. Download the latest version of Miniconda by opening a terminal and running one of the following commands (depending on your Linux architecture and preferred download tool):

   <Warning>
     The `linux-aarch64` package builds might not be compatible with certain Raspberry Pi setups, as Miniconda uses compiler options that target the server-class Neoverse N1/N2 microarchitecture.
   </Warning>

   <Tabs>
     <Tab title="curl">
       Choose your architecture:

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

         ```sh AWS Graviton2/ARM64 theme={null}
         curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
         ```
       </CodeGroup>
     </Tab>

     <Tab title="wget">
       Choose your architecture:

       <CodeGroup>
         ```sh Linux x86 theme={null}
         wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
         ```

         ```sh AWS Graviton2/ARM64 theme={null}
         wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
         ```
       </CodeGroup>
     </Tab>
   </Tabs>

   <Note>
     For instructions on downloading an older installer version, see [Using older installer versions](/getting-started/advanced-install/old-os).
   </Note>

2. (Optional) Anaconda recommends verifying the integrity of the installer after downloading it.

   <Accordion title="How do I verify my installer's integrity?">
     To ensure that your downloaded installer has not been tampered with or corrupted, generate its SHA-256 hash value and compare that hash to the official hash provided in the archive.

     1. Open a terminal and run the following command:

          <CodeGroup>
            ```sh Hash comparison command theme={null}
            sha256sum <PATH_TO_INSTALLER_FILE>
            ```

            ```sh Example theme={null}
            sha256sum ./Miniconda3-latest-Linux-x86_64.sh
            ```
          </CodeGroup>

          <Comments>
            Replace \<PATH\_TO\_INSTALLER\_FILE> with the file path to the downloaded installer file.
          </Comments>

     2. Note the generated SHA-256 hash value from the output.

     3. Visit [repo.anaconda.com/miniconda](https://repo.anaconda.com/miniconda/) to find the official SHA-256 hash for your installer.

     4. Compare the hash values. If they match, the installer is safe to use.

     <Tip>
       For more information, see [cryptographic hash verification](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html#cryptographic-hash-verification) in the official conda documentation.
     </Tip>
   </Accordion>

3. Install Miniconda by running one of the following commands (depending on your Linux architecture):

   <Warning>
     The `linux-aarch64` package builds might not be compatible with certain Raspberry Pi setups, as Miniconda uses compiler options that target the server-class Neoverse N1/N2 microarchitecture.
   </Warning>

   <CodeGroup>
     ```sh Linux x86 theme={null}
     bash ./Miniconda3-latest-Linux-x86_64.sh
     ```

     ```sh AWS Graviton2/ARM64 theme={null}
     bash ./Miniconda3-latest-Linux-aarch64.sh
     ```
   </CodeGroup>

4. Press Return to review [Miniconda's End User License Agreement (EULA)](https://www.anaconda.com/legal/terms/miniconda). You can view Anaconda's Terms of Service (TOS) at [https://www.anaconda.com/legal](https://www.anaconda.com/legal).

5. Enter `yes` to agree to the EULA.

6. Press Return to accept the default install location (`PREFIX=/home/<USER>/miniconda3`), or enter another file path to specify an alternate installation directory. The installation might take a few minutes to complete.

7. Choose `yes` when asked if you want to initialize conda. This modifies your shell configuration to initialize conda whenever you open a new shell and to recognize conda commands automatically.

8. The installer finishes and displays, "Thank you for installing Miniconda3!"

9. Close and re-open your terminal window for the installation to fully take effect, or use the following command to refresh the terminal, depending on your shell:

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

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

     ```sh Fish theme={null}
     exec fish
     ```
   </CodeGroup>

   <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](/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 /home/<USER>/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>

## What's next?

* Integrate conda with your [preferred IDE](/getting-started/guides/ides/main) to streamline package management directly in your development environment.
* Explore [Working with conda](/getting-started/working-with-conda/main) to understand channels, environments, and package management workflows.
* The official [conda documentation](https://docs.conda.io/en/latest/) covers advanced topics like custom channels, build recipes, and performance optimization.

## 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](/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](/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](/getting-started/anaconda/main) or [Miniconda](/getting-started/miniconda/main).

        <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>
    ### 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 (Cloud) organization and you require access to channels in that organization.
           </Note>

    2. [Install](/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](/anaconda-platform/cloud/getting-started-with-anaconda-platform#using-anaconda-behind-a-firewall-or-proxy-optional).
  </TroubleshootSolution>
</Troubleshoot>