Installing Anaconda Distribution
Using Anaconda in a commercial setting?
Using Anaconda in a commercial setting?
- 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 Anaconda Distribution manually. Consider requesting that your IT admin add Anaconda Distribution to a software delivery or fleet management system (such as Kanji, Jamf, etc.).
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.
Windows installation
Windows installation
-
Download the installer from the Anaconda website or by using your preferred command line interface:
Navigate to anaconda.com/download, register with Anaconda (if desired), and click Download under Distribution Installers.
-
(Recommended) Verify the integrity of your installer to ensure that it was not corrupted or tampered with during download.
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 it to the official hash provided in the archive.-
Open PowerShell and run the following command:
For example:
- Note the generated SHA-256 hash value from the output.
- Visit repo.anaconda.com/archive to find the official SHA-256 hash for your installer.
- 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. -
Open PowerShell and run the following command:
-
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.
- Anaconda recommends installing Anaconda Distribution in a directory with no spaces or special characters to avoid potential compatibility issues with open-source tools. 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, and so on.
-
Clear the package cache upon completion - Runs
conda clean --all --force-pkgs-dirsafter 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.
- Open Anaconda Prompt to use Anaconda Distribution.
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.
macOS/Linux installation
macOS/Linux installation
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.- Navigate to anaconda.com/download, register with Anaconda (if desired), and click Download for Mac under Distribution Installers.
-
(Recommended) Verify the integrity of your installer to ensure that it was not corrupted or tampered with during download.
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 it to the official hash provided in the archive.-
Open Terminal and run the following command:
For example:
- Note the generated SHA-256 hash value from the output.
- Visit repo.anaconda.com/archive to find the official SHA-256 hash for your installer.
-
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.
-
Open Terminal and run the following command:
- 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/anaconda3for 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. - Install for all users of this computer (Recommended) - Installs Anaconda Distribution into
-
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.
Verify your install
Verify your install
Anaconda Navigator, the Graphical User Interface (GUI) for conda, should automatically open after successful installation of Anaconda Distribution.If it does not, verify your installation by opening the application manually, or by using the CLI:
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