CLI Docs


Package an existing conda environment into an archive file.

usage: conda-pack [--name ENV] [--prefix PATH] [--output PATH]
                  [--arcroot PATH] [--dest-prefix PATH]
                  [--parcel-root PARCEL_ROOT] [--parcel-name PARCEL_NAME]
                  [--parcel-version PARCEL_VERSION]
                  [--parcel-distro PARCEL_DISTRO]
                  [--format {infer,zip,tar.gz,tgz,tar.bz2,tbz2,tar.xz,txz,tar,parcel,squashfs}]
                  [--compress-level LEVEL] [--n-threads N] [--zip-symlinks]
                  [--no-zip-64] [--ignore-editable-packages]
                  [--ignore-missing-files] [--exclude PATTERN]
                  [--include PATTERN] [--force] [--quiet] [--help] [--version]
--name <env>, -n <env>

The name of the environment to pack. If neither –name nor –prefix are supplied, the current activated environment is packed.

--prefix <path>, -p <path>

The path to the environment to pack. Only one of –name/–prefix should be supplied.

--output <path>, -o <path>

The path of the output file. Defaults to the environment name with a .tar.gz suffix (e.g. my_env.tar.gz).

--arcroot <path>

The relative path in the archive to the conda environment. Defaults to ‘’.

--dest-prefix <path>, -d <path>

If present, prefixes will be rewritten to this path before packaging. In this case the conda-unpack script will not be generated. This option should not be used with parcels, which instead generate their destination prefix from the –parcel-root, –parcel-name, and –parcel-version options.

--parcel-root <parcel_root>

(Parcels only) The location where all parcels are unpacked on the target Hadoop cluster (default: ‘/opt/cloudera/parcels’).

--parcel-name <parcel_name>

(Parcels only) The name of the parcel, without a version suffix. The default value is the local environment name. The parcel name may not have any hyphens.

--parcel-version <parcel_version>

(Parcels only) The version number for the parcel. The default value is the current date, using the format YYYY.MM.DD.

--parcel-distro <parcel_distro>

(Parcels only) The distribution type for the parcel. The default value is ‘el7’. This value cannot have any hyphens.

--format {infer,zip,tar.gz,tgz,tar.bz2,tbz2,tar.xz,txz,tar,parcel,squashfs}

The archival format to use. By default this is inferred by the output file extension.

--compress-level <level>

The compression level to use, from 0 to 9. Higher numbers decrease output file size at the expense of compression time. Ignored for format='zip'. Default is 4.

--n-threads <n>, -j <n>

The number of threads to use. Set to -1 to use the number of cpus on this machine. If a file format doesn’t support threaded packaging, this option will be ignored. Default is 1.

Symbolic links aren’t supported by the Zip standard, but are supported by many common Zip implementations. If set, store symbolic links in the archive, instead of the file referred to by the link. This can avoid storing multiple copies of the same files. Note that the resulting archive may silently fail on decompression if the ``unzip`` implementation doesn’t support symlinks. Ignored if format isn’t zip.


Disable ZIP64 extensions.


Skips checks for editable packages.


Skip checks for missing package files.


Exclude files matching this pattern


Re-add excluded files matching this pattern

--force, -f

Overwrite any existing archive at the output path.

--quiet, -q

Do not report progress

--help, -h

Show this help message then exit


Show version then exit