`conda update`#

Update conda packages to the latest compatible version.

This command accepts a list of package names and updates them to the latest versions that are compatible with all other packages in the environment.

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 --no-update-deps option. This may force conda to install older versions of the requested packages, and it does not prevent additional dependency packages from being installed.

usage: conda update [-h] [-n ENVIRONMENT | -p PATH] [-c CHANNEL] [--use-local]
                    [--override-channels] [--repodata-fn REPODATA_FNS]
                    [--experimental {jlap,lock}] [--no-lock]
                    [--repodata-use-zst | --no-repodata-use-zst]
                    [--strict-channel-priority] [--no-channel-priority]
                    [--no-deps | --only-deps] [--no-pin] [--copy]
                    [--no-shortcuts] [--shortcuts-only SHORTCUTS_ONLY] [-C]
                    [-k] [--offline] [--json] [--console CONSOLE] [-v] [-q]
                    [-d] [-y] [--download-only] [--show-channel-urls]
                    [--file FILE] [--solver {classic}] [--force-reinstall]
                    [--freeze-installed | --update-deps | -S | --update-all | --update-specs]
                    [--clobber]
                    [package_spec ...]

Positional Arguments#

package_spec: List of packages to install or update in the conda environment.

Named Arguments#

--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

Additional channel to search for packages. These are URLs searched in the order they are given (including local directories using the 'file://' syntax or simply a path like '/home/conda/mychan' or '../mychan'). Then, the defaults or channels from .condarc are searched (unless --override-channels is given). You can use 'defaults' to get the default packages for conda. You can also use any name and the .condarc channel_alias value will be prepended. The default channel_alias is https://conda.anaconda.org/.

--use-local

Use locally built packages. Identical to '-c local'.

--override-channels

Do not search default or .condarc channels. Requires --channel.

--repodata-fn

Specify file name of repodata on the remote server where your channels are configured or within local backups. Conda will try whatever you specify, but will ultimately fall back to repodata.json if your specs are not satisfiable with what you specify here. This is used to employ repodata that is smaller and reduced in time scope. You may pass this flag more than once. Leftmost entries are tried first, and the fallback to repodata.json is added for you automatically. For more information, see conda config --describe repodata_fns.

--experimental

Possible choices: jlap, lock

jlap: Download incremental package index data from repodata.jlap; implies 'lock'. lock: use locking when reading, updating index (repodata.json) cache. Now enabled.

--no-lock

Disable locking when reading, updating index (repodata.json) cache.

--repodata-use-zst, --no-repodata-use-zst

Check for/do not check for repodata.json.zst. Enabled by default. (default: Null)

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.

--solver

Possible choices: classic

Choose which solver backend to use.

--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 that have available updates.

-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 the 'aggressive_update_packages' config setting. Use 'conda config --describe aggressive_update_packages' to view your setting. --satisfied-skip-solve is similar to the default behavior of 'pip install'.

--update-all, --all

Update all installed packages in the environment.

--update-specs

Update based on provided specifications.

Package Linking and Install-time Options#

--copy: Install all packages using copies instead of hard- or soft-linking.
--no-shortcuts: Don't install start menu shortcuts
--shortcuts-only: Install shortcuts only for this package name. Can be used several times.
--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. This is useful if you don't want conda to check whether a new version of the repodata file exists, which will save bandwidth.
-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#

--json: Report all output as json. Suitable for using conda programmatically.
--console: Select the backend to use for normal output rendering.
-v, --verbose: Can be used multiple times. Once for detailed output, twice for INFO logging, thrice for DEBUG logging, four times for TRACE logging.
-q, --quiet: Do not display progress bar.
-d, --dry-run: Only display what would have been done.
-y, --yes: Sets any confirmation values to 'yes' automatically. Users will not be asked to confirm any adding, deleting, backups, etc.
--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 update -n myenv scipy

conda update#