Environment variables

ggg reads the following environment variables at runtime.

GGG_CACHE_DIR

Overrides the default location of the shared cache directory. When set, all cached Godot binaries and dependency archives are stored under this path instead of the platform default.

PlatformDefault (when unset)
Linux~/.local/share/ggg/
macOS~/Library/Application Support/ggg/
Windows%APPDATA%\ggg\
GGG_CACHE_DIR=/mnt/fast-ssd/ggg-cache ggg sync

Useful for CI environments where you want to place the cache on a specific volume, or for developers who prefer to keep all tool caches in a central location.

See the cache reference for details about the directory structure.

NO_COLOR

When set to any value, ggg diff suppresses coloured output and emits plain unified diff text instead. Set automatically by most CI environments.

NO_COLOR=1 ggg diff

Proxy variables

ggg uses reqwest for all HTTP requests (Godot downloads, asset library API calls, archive dependency downloads). reqwest automatically honours the standard proxy environment variables:

VariablePurpose
HTTPS_PROXYProxy for HTTPS requests
HTTP_PROXYProxy for HTTP requests
NO_PROXYComma-separated list of hosts to connect to directly, bypassing the proxy

Lowercase variants (https_proxy, http_proxy, no_proxy) are also accepted.

HTTPS_PROXY=http://proxy.example.com:8080 ggg sync