Installing Anaconda Distribution

This page provides instructions for installing Anaconda Distribution on Windows, macOS, and Linux.

If you prefer an installation without the extensive collection of packages included in Anaconda Distribution, install Miniconda instead. Miniconda is a free, miniature installation of Anaconda Distribution that includes only conda, Python, the packages they both depend on, and a small number of other useful packages.

Basic install instructions

If you’ve installed multiple versions of Anaconda Distribution, the system defaults to using the most current version, as long as you haven’t altered the default install path.

More of a visual learner? Sign in to Anaconda Cloud and watch the Installing Anaconda (Windows) video in our Get Started with Anaconda course. This video guides you through installation in a quick two minutes.

Download the installer from the Anaconda website or by using your preferred command line interface:
On anaconda.com/download, register with Anaconda and click Download.
(Recommended) Verify the integrity of your installer to ensure that it was not corrupted or tampered with during download.
To ensure that your downloaded installer has not been tampered with or corrupted, generate its SHA-256 hash value and compare it to the official hash provided in the archive.
1. Open PowerShell and run the following command:
  # Replace <INSTALLER_FILE> with the name of the downloaded installer file Get-FileHash .\Downloads\<INSTALLER_FILE> -Algorithm SHA256
  For example:
  Get-FileHash .\Downloads\Anaconda3-2024.10-1-Windows-x86_64.exe -Algorithm SHA256
2. Note the generated SHA-256 hash value from the output.
3. Visit repo.anaconda.com/archive 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.
Go to your Downloads folder (or Home folder if downloaded via CLI) and double-click the installer to launch.

To prevent permission errors, do not launch the installer from the Favorites folder.

If you encounter issues during installation, temporarily disable your anti-virus software during install, then re-enable it after the installation concludes. If you installed for All Users, uninstall Anaconda and re-install it for Just Me only.
Click Next and then agree to the Anaconda’s Terms of Service (TOS).
Select an installation option:
- Just Me (Recommended): Install Anaconda Distribution for the current user account.
- All Users: Install Anaconda Distribution for all user accounts on the computer (requires Windows Administrator privileges).
Click Next.
Select a destination folder to install Anaconda, then click Next.
- The installation directory path cannot contain spaces or Unicode characters. For more information, see the FAQ.
- Do not install as Administrator unless admin privileges are required.
Customize your installation options:
- Create shortcuts - Selected by default. Creates Start Menu shortcuts for the Anaconda Navigator, Spyder, Jupyter Notebook, and Anaconda Prompt packages. Deselecting this option skips creating these shortcuts.
- Add Anaconda3 to my PATH environment variable - Adds the path that contains the conda binaries to your PATH environment variable. Anaconda does not recommend selecting this option. The conda binaries path contains other package binaries, which are permanently added to your PATH environment variable, even if no conda environment is currently active. This makes it possible for other software to use these package files, which might lead to errors.
  
  Unless you plan on installing and running multiple versions of Anaconda Distribution or Python, open Anaconda Navigator or the Anaconda Prompt from the Start Menu to begin your environment management work.
  
  As of Anaconda Distribution 2022.05, the option to add Anaconda to the PATH environment variable during an All Users installation has been disabled. This was done to address a security exploit. You can still add Anaconda to the PATH environment variable during a Just Me installation.
- Register Anaconda3 as my default Python 3.12 - Selected by default. Registers the Python package in this install as the default Python for programs like VSCode, PyCharm, etc.
- Clear the package cache upon completion - Runs conda clean --all --force-pkgs-dirs after the install finishes. For more information on these commands, see the conda command documentation.
Click Install. The installation might take a few minutes to complete. Click Show details to view the packages being installed.
Click Next twice, then click Finish to close the installer.

If you are behind a company proxy, you might need to do some additional setup. For more information, see Using Anaconda behind a company proxy.

More of a visual learner? Sign in to Anaconda Cloud and watch the Installing Anaconda (Mac) video in our Get Started with Anaconda course. This video guides you through using the graphical installer in a quick two minutes.

The graphical installer for macOS installs Anaconda into /opt/anaconda3 in your file system. If you want to install Anaconda into your Home directory or if you have multiple users on a system and want to manage your installation more carefully, Anaconda recommends following the instructions in the macOS Command Line installer tab.

Download the graphical (.pkg) macOS installer for your system.
(Recommended) Verify the integrity of your installer to ensure that it was not corrupted or tampered with during download.
To ensure that your downloaded installer has not been tampered with or corrupted, generate its SHA-256 hash value and compare it to the official hash provided in the archive.
1. Open Terminal and run the following command:
  # Replace <INSTALLER-FILE> with the name of the downloaded installer file shasum -a 256 ~/Downloads/<INSTALLER-FILE>
  For example:
  shasum -a 256 ~/Downloads/Anaconda3-2024.10-1-MacOSX-x86_64.pkg
2. Note the generated SHA-256 hash value from the output.
3. Visit repo.anaconda.com/archive 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.
Double-click the downloaded file and click Continue to start the installation.
View the Read Me instructions and click Continue.
Read through the Anaconda’s Terms of Service (TOS) and click Continue, then click Agree to agree to the terms.

For installer versions 2023.09 or older, the installer might skip the Destination Select page during installation, which will cause the installation to fail. If the installer skips this page, click Change Install Location… on the Installation Type page to get to this step.
Choose an install location:
- Install for all users of this computer (Recommended) - Installs Anaconda Distribution into /opt/anaconda3 for all users of the computer.
- Install on a specific disk - Enables you to choose a different location to install Anaconda Distribution.
If you get the error message “You cannot install Anaconda in this location,” reselect Install for all users of this computer and try again.
Click Install. The installation may take a few minutes to complete.

If you get the error message “This package is incompatible with this version of macOS,” please see here for troubleshooting help.
Click Continue.
Click Close to exit the installer.

Advanced install options

For more advanced installation instructions, such as installing with silent mode, installing on older operating systems, or multi-user installs, see Advanced installation.

Other ways to get Anaconda or Miniconda

For instructions on using Anaconda Docker images or the Anaconda Cloudera Distributed Hadoop cluster, see Applications/Integrations.

Problems?

Troubleshooting guide for general troubleshooting
Help and support for resources such as community support and bug reports

What’s next?

Get started programming with Anaconda in the Getting started with Anaconda guide.

Visit Anaconda Cloud to start programming for FREE in a notebook. Learn how from Anaconda Learning, too!

Getting Started

​Basic install instructions

​Advanced install options

​Other ways to get Anaconda or Miniconda

​Problems?

​What’s next?

Basic install instructions

Advanced install options

Other ways to get Anaconda or Miniconda

Problems?

What’s next?