Skip to main content
Bach reads a few environment variables. Most matter only in CI or on machines that cannot reach GitHub. This page lists them, grouped by what reads them.

The bach command

The runtime download is saved to a cache: %LOCALAPPDATA%\bach\runtime\<version> on Windows, and $XDG_CACHE_HOME/bach/runtime/<version> (or ~/.cache/bach/runtime/<version>) elsewhere. It is created for its owner only on macOS and Linux, and it is hashed again before every use. A released bach checks the hash built into it. A bach built from source checks the .sha256 published next to the file, which only catches a damaged download. With no LOCALAPPDATA (Windows), or neither XDG_CACHE_HOME nor HOME (elsewhere), there is no cache and no fallback to the shared temp folder: pass --runtime or set BACH_RUNTIME. Downloads use https only, redirects included.

The install scripts

install.ps1 refuses a folder that holds files it did not put there. Set BACH_INSTALL_DIR to an empty folder in that case.

The installer window

See Install Bach and Automate in CI.