Environment Variables

Variables read by boks

VariableDescription
BOKS_CONFIGPath to a custom boks.toml file
CIWhen set (any value), disables TTY — same as --non-interactive

Examples

# Use a project-local config
BOKS_CONFIG=./boks.toml boks python --version

# Explicit non-interactive mode (CI/CD)
CI=true boks python -c "print('ok')"

Variables passed into containers

By default, no host environment variables are passed to containers. Configure pass-through in boks.toml:

[global]
pass_env = ["AWS_*", "GITHUB_TOKEN", "HTTP_PROXY"]

See Environment Variables in the Configuration section for details.