Skip to main content
Gandalf reads a small set of environment variables to override defaults and gate destructive operations. Every variable is optional. The CLI still requires explicit flags for mutation even when environment variables are set.

​
Reference

​
HOME

Gandalf resolves user-scope evidence relative to HOME. Override the effective home with the --home flag or by setting HOME in your shell environment.

​
GANDALF_STORE

Points to the on-disk store for snapshots, timeline entries, and the store index. The default is ~/.gandalf. The CLI resolution order is:
  1. --store <path> flag.
  2. $GANDALF_STORE.
  3. Default ~/.gandalf.

​
GANDALF_EXPERIMENTAL

Gates destructive operations. Setting GANDALF_EXPERIMENTAL=1 is equivalent to passing --experimental on the affected commands. It does not replace the operation-specific flag: you still need --apply on gandalf restore and --apply-content on gandalf bundle import. Effective combinations:
  • gandalf restore --snapshot <name> --apply --experimental or gandalf restore --snapshot <name> --apply with GANDALF_EXPERIMENTAL=1.
  • gandalf bundle import <bundle> --apply-content --experimental or gandalf bundle import <bundle> --apply-content with GANDALF_EXPERIMENTAL=1.

​
GANDALF_UPDATE_CHECK

Update notices are off by default in line with the Trust contract. Set GANDALF_UPDATE_CHECK=1 to opt in to update checks.