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.

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.

GGG_GODOT_DATA_DIR

Overrides the Godot editor data directory used when installing export templates. When set, ggg installs templates under this path instead of the platform default. On Linux this is normally ~/.local/share/godot/; on macOS ~/Library/Application Support/Godot/; on Windows %APPDATA%\Godot\.

GGG_GODOT_DATA_DIR=/tmp/godot-data ggg sync

Useful for integration tests and CI environments where writing to the real Godot data directory is undesirable.

GGG_GODOT_EXECUTABLE

Points ggg at a pre-installed Godot executable instead of the managed one. Honoured by ggg run, ggg edit, and ggg sync; when set, no Godot engine is downloaded or cached and the Godot version declared in ggg.toml is not managed.

export GGG_GODOT_EXECUTABLE=/opt/godot/godot
ggg sync

The path must exist and be a regular file, otherwise the command fails with an error naming the variable. ggg run, ggg edit, and ggg sync also accept a --godot <path> flag; the flag takes precedence over this variable.

Useful for distributions and toolchains where Godot is installed through a system package manager and you do not want ggg to manage a second copy.

Endpoint overrides

Each of the hardcoded remote endpoints ggg talks to (Godot versions manifest, engine builds API, asset library API, asset store API, export template downloads) can be overridden with an environment variable. This is primarily intended for testing and for mirroring the endpoints, letting you point ggg at a local or proxied server without code changes.

When unset, the built-in default URL is used.

GGG_GODOT_MANIFEST_URL=http://localhost:8080/versions.yml ggg sync

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:

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

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