Environment Variables

Environment Variables

Common GUESTKIT_* knobs. Also see CLI guide and cloud disk sources.

Variable	Purpose
GUESTKIT_PACKAGE_CACHE	Host dirs of .rpm/.deb for offline PackageInstall staging
GUESTKIT_PACKAGE_FETCH	1/true/yes/on — host-download missing packages before staging
GUESTKIT_PACKAGE_MIRROR	Comma-separated HTTP bases for fetch fallback (curl/wget); optional {name} / {ext}
GUESTKIT_VIRTIO_WIN	VirtIO driver tree for offline Windows DriverInject
GUESTKIT_FLEET_JOBS	Parallelism for fleet analyze (default min(4, CPUs))
GUESTKIT_S3_ENDPOINT / AWS_ENDPOINT_URL	Custom S3-compatible endpoint for cloud disk pulls
XDG_CACHE_HOME	Influences default package fetch cache under …/guestkit/packages

Quick examples

export GUESTKIT_PACKAGE_CACHE=~/pkgs
export GUESTKIT_PACKAGE_FETCH=1
export GUESTKIT_PACKAGE_MIRROR=https://mirror.example/pkgs
export GUESTKIT_VIRTIO_WIN=/opt/virtio-win
export GUESTKIT_FLEET_JOBS=8

Related wiki

• Offline Packages and Services
• Day-Zero and Rescue