Environment and Configuration
The latest version of this documentation is available on GitHub.
This environment variable can be set to an existing directory to use for storing downloads instead of the internal
downloads/ directory. It should always be set to an absolute path.
This environment variable can be set to a comma-separated list of off-by-default features in vcpkg. These features are subject to change without notice and should be considered highly unstable.
Non-exhaustive list of off-by-default features:
This environment variable can be set to the full path of an executable to be used for
vcpkg edit. Please see
vcpkg help edit for command-specific help.
This environment variable can be set to a directory to use as the root of the vcpkg instance. Note that mixing vcpkg repo versions and executable versions can cause issues.
This environment variable can be set to the full path to a Visual Studio instance on the machine. This Visual Studio instance
will be used if the triplet does not override it via the
VCPKG_VISUAL_STUDIO_PATH triplet setting.
This environment variable can be set to a triplet name which will be used for unqualified triplet references in command lines.
This environment variable can be set to a triplet name which will be used for unqualified host port references in command lines and all host port references in dependency lists. See the host-dependencies documentation for more information.
This environment variable allows users to override ports with alternate versions according to the
ports overlay specification. List paths to overlays using
the platform dependent PATH separator (Windows
; | others
This environment variable allows users to add directories to search for triplets.
Example: overlay triplets.
List paths to overlays using the platform dependent PATH separator (Windows
This environment variable, if set, suppresses the downloading of CMake and Ninja and forces the use of the system binaries.
This environment variable can be set to a list of environment variables, separated by
;, which will be propagated to
the build environment.
This environment variables limits the amount of concurrency requested by underlying buildsystems. If unspecified, this defaults to logical cores + 1.
This environment variable redirects the default location to store binary packages. See Binary Caching for more details.
This environment variable adds or removes binary sources. See Binary Caching for more details.
This environment variable changes the metadata of produced NuGet packages. See Binary Caching for more details.
This environment variable allows using NuGet's cache for every nuget-based binary source. See Binary Caching for more details.
Note: This is an experimental feature and may change or be removed at any time
This environment variable allows using a private mirror for all SHA512-tagged assets. See Asset Caching for more details.