conda install
¶
Installs a list of packages into a specified conda environment.
This command accepts a list of package specifications (e.g, bitarray=0.8) and installs a set of packages consistent with those specifications and compatible with the underlying environment. If full compatibility cannot be assured, an error is reported and the environment is not changed.
Conda attempts to install the newest versions of the requested packages. To accomplish this, it may update some packages that are already installed, or install additional packages. To prevent existing packages from updating, use the –freeze-installed option. This may force conda to install older versions of the requested packages, and it does not prevent additional dependency packages from being installed.
If you wish to skip dependency checking altogether, use the ‘–no-deps’ option. This may result in an environment with incompatible packages, so this option must be used with great caution.
conda can also be called with a list of explicit conda package filenames (e.g. ./lxml-3.2.0-py27_0.tar.bz2). Using conda in this mode implies the –no-deps option, and should likewise be used with great caution. Explicit filenames and package specifications cannot be mixed in a single command.
Options:
usage: conda install [-h] [--revision REVISION] [-n ENVIRONMENT | -p PATH]
[-c CHANNEL] [--use-local] [--override-channels]
[--strict-channel-priority] [--no-channel-priority]
[--no-deps | --only-deps] [--no-pin] [--copy] [-C] [-k]
[--offline] [-d] [--json] [-q] [-v] [-y]
[--download-only] [--show-channel-urls] [--file FILE]
[--prune] [--force-reinstall]
[--freeze-installed | --update-deps | -S | --update-all]
[-m] [--clobber]
[package_spec [package_spec ...]]
Positional Arguments¶
package_spec | Packages to install or update in the conda environment. |
Named Arguments¶
--revision | Revert to the specified REVISION. |
--file | Read package versions from the given file. Repeated file specifications can be passed (e.g. –file=file1 –file=file2). |
Target Environment Specification¶
-n, --name | Name of environment. |
-p, --prefix | Full path to environment location (i.e. prefix). |
Channel Customization¶
-c, --channel |
|
--use-local | Use locally built packages. Identical to ‘-c local’. |
--override-channels | |
Do not search default or .condarc channels. Requires –channel. |
Solver Mode Modifiers¶
--strict-channel-priority | |
Packages in lower priority channels are not considered if a package with the same name appears in a higher priority channel. | |
--no-channel-priority | |
Package version takes precedence over channel priority. Overrides the value given by conda config –show channel_priority. | |
--no-deps | Do not install, update, remove, or change dependencies. This WILL lead to broken environments and inconsistent behavior. Use at your own risk. |
--only-deps | Only install dependencies. |
--no-pin | Ignore pinned file. |
--prune | Remove packages that have previously been brought into the environment to satisfy dependencies of user-requested packages, but are no longer needed. |
--force-reinstall | |
Ensure that any user-requested package for the current operation is uninstalled and reinstalled, even if that package already exists in the environment. | |
--freeze-installed, --no-update-deps | |
Do not update or change already-installed dependencies. | |
--update-deps | Update dependencies. |
-S, --satisfied-skip-solve | |
Exit early and do not run the solver if the requested specs are satisfied. Also skips aggressive updates as configured by ‘aggressive_update_packages’. Similar to the default behavior of ‘pip install’. | |
--update-all, --all | |
Update all installed packages in the environment. |
Package Linking and Install-time Options¶
--copy | Install all packages using copies instead of hard- or soft-linking. |
-m, --mkdir | Create the environment directory if necessary. |
--clobber | Allow clobbering of overlapping file paths within packages, and suppress related warnings. |
Networking Options¶
-C, --use-index-cache | |
Use cache of channel index files, even if it has expired. | |
-k, --insecure | Allow conda to perform “insecure” SSL connections and transfers. Equivalent to setting ‘ssl_verify’ to ‘false’. |
--offline | Offline mode. Don’t connect to the Internet. |
Output, Prompt, and Flow Control Options¶
-d, --dry-run | Only display what would have been done. |
--json | Report all output as json. Suitable for using conda programmatically. |
-q, --quiet | Do not display progress bar. |
-v, --verbose | Can be used multiple times. Once for INFO, twice for DEBUG, three times for TRACE. |
-y, --yes | Do not ask for confirmation. |
--download-only | |
Solve an environment and ensure package caches are populated, but exit prior to unlinking and linking packages into the prefix. | |
--show-channel-urls | |
Show channel urls. Overrides the value given by conda config –show show_channel_urls. |
Examples:
conda install -n myenv scipy