conda create

Create a new conda environment from a list of specified packages. To use the newly-created environment, use 'conda activate envname'. This command requires either the -n NAME or -p PREFIX option.

usage: conda create [-h] [--clone ENV] (-n ENVIRONMENT | -p PATH) [-c CHANNEL]
                    [--use-local] [--override-channels]
                    [--repodata-fn REPODATA_FNS] [--experimental {jlap,lock}]
                    [--no-lock] [--strict-channel-priority]
                    [--no-channel-priority] [--no-deps | --only-deps]
                    [--no-pin] [--copy] [-C] [-k] [--offline] [--json] [-v]
                    [-q] [-d] [-y] [--download-only] [--show-channel-urls]
                    [--file FILE] [--no-default-packages] [--solver {classic}]
                    [package_spec ...]

Positional Arguments


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



Create a new environment as a copy of an existing local environment.


Read package versions from the given file. Repeated file specifications can be passed (e.g. --file=file1 --file=file2).


Use sys.executable -m conda in wrapper scripts instead of CONDA_EXE. This is mainly for use during tests where we test new conda sources against old Python versions.

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


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


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


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.


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.


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

Solver Mode Modifiers


Packages in lower priority channels are not considered if a package with the same name appears in a higher priority channel.


Package version takes precedence over channel priority. Overrides the value given by conda config --show channel_priority.


Do not install, update, remove, or change dependencies. This WILL lead to broken environments and inconsistent behavior. Use at your own risk.


Only install dependencies.


Ignore pinned file.


Ignore create_default_packages in the .condarc file.


Possible choices: classic

Choose which solver backend to use.

Package Linking and Install-time Options


Install all packages using copies instead of hard- or soft-linking.

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 mode. Don't connect to the Internet.

Output, Prompt, and Flow Control Options


Report all output as json. Suitable for using conda programmatically.

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


Solve an environment and ensure package caches are populated, but exit prior to unlinking and linking packages into the prefix.


Show channel urls. Overrides the value given by conda config --show show_channel_urls.


Create an environment containing the package 'sqlite':

conda create -n myenv sqlite

Create an environment (env2) as a clone of an existing environment (env1):

conda create -n env2 --clone path/to/file/env1