Installing Miniconda
Using Miniconda in a commercial setting?
Using Miniconda 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 Miniconda manually. Consider requesting that your IT admin add Miniconda to a software delivery or fleet management system (such as Kanji, Jamf, etc.).
On Windows, macOS, and Linux, it is best to install Miniconda for the local user, which does not require administrator permissions and is the most robust type of installation. However, if you need to, you can install Miniconda system wide, which does require administrator permissions.
Basic install instructions
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 for Windows under Miniconda 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/miniconda 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 Miniconda and re-install it for Just Me only.
- Click Next and then agree to Anaconda’s Terms of Service (TOS) .
-
Select an installation option:
- Just Me (Recommended) - Install Miniconda for the current user account.
- All Users - Install Miniconda for all user accounts on the computer (requires Windows Administrator privileges).
- Click Next.
-
Select a destination folder to install Miniconda, then click Next.
- Anaconda recommends installing Miniconda 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 Prompt packages. Deselecting this option skips creating these shortcuts.
- Add Miniconda3 to my PATH environment variable - Adds the path that contains the conda binaries to your PATH environment variable.
Unless you plan on installing and running multiple versions of Miniconda or Python, open Anaconda Prompt from the Start Menu to begin your environment management work.- Register Miniconda3 as my default Python 3.13 - 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 Miniconda.
macOS/Linux installation
macOS/Linux installation
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 shell (or command line) installer.- Navigate to anaconda.com/download, register with Anaconda (if desired), and click Download for Mac under Miniconda Installers.
-
(Optional) Anaconda recommends verifying the integrity of the installer after downloading it.
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/miniconda 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
.pkgfile. - View the Read Me instructions and click Continue.
- Read through Anaconda’s Terms of Service (TOS) and click Continue, then click Agree to agree to the terms.
-
Choose an install location:
- Install for all users of this computer (Recommended) - Installs Miniconda into /opt/miniconda3 for all users of the computer.
- Install on a specific disk - Enables you to choose a different location to install Miniconda.
-
Click Install. When the installation finishes, open your terminal application.
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. -
Test your installation by running
conda list. If conda has been installed correctly, a list of installed packages appears.
Verify your install
Verify your install
Verify your installation of Miniconda by using the CLI:
-
Access the CLI for your operating system:
You should see
- Search for “Anaconda Prompt” in the taskbar search.
- Select Anaconda Prompt.
(base)in the command line prompt. This tells you that you’re in your base conda environment. To learn more about environments, see Environments. -
Run any conda command. For example:
conda list- Displays a list of packages installed in your active environment and their versions.conda --version- Displaysconda’s version number.
Quickstart install instructions
These command line instructions will get you set up quickly with the latest Miniconda installer. Follow the steps for your system to download and install Miniconda, then follow the steps in Verify your install above to verify your Miniconda installation.These quick install commands run a silent install. If you run a silent install, you are accepting Anaconda’s Terms of Service (TOS) by default. Please make sure to review Anaconda’s full TOS here before proceeding with silent installations.
These three commands quickly and quietly download the latest 64-bit Windows installer, rename it to a shorter file name, perform a silent install, and then delete the installer:
After installing, open Anaconda Prompt to use Miniconda.
To download an older version
To download an older version
You can find older versions of the Windows installer at
<https://repo.anaconda.com/miniconda>.For example, to download an older version of Miniconda for Python 3.12 for a 64-bit Windows computer, replace the curl command for the latest installer with the following curl command instead: