Skip to main content
  • You might need to purchase a license to stay compliant with our Terms of Service.
  • 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, etc.).
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):
    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.
    curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
    
    For instructions on downloading an older installer version, see Using older installer versions.
  2. (Optional) Anaconda recommends verifying the integrity of the installer after downloading it.
    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:
      sha256sum <PATH_TO_INSTALLER_FILE>
      
    2. Note the generated SHA-256 hash value from the output.
    3. Visit 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.
    For more information, see cryptographic hash verification in the official conda documentation.
  3. Install Miniconda by running one of the following commands (depending on your Linux architecture):
    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.
    bash ~/Miniconda3-latest-Linux-x86_64.sh
    
  4. Press Return to review Miniconda’s End User License Agreement (EULA). You can view Anaconda’s Terms of Service (TOS) at 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:
    source ~/.bashrc
    
    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.

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:
(base) ~ conda list

What’s next?

  • Integrate conda with your preferred IDE to streamline package management directly in your development environment.
  • Explore Working with conda to understand channels, environments, and package management workflows.
  • The official conda documentation 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.

Troubleshooting