AutoMax
Reference

Environment variables

Every variable AutoMax reads.

VariableUsed byMeaning
AUTOMAX_PROJECT, AUTOMAX_ENVruntimeproject and environment selection (run sets them for workers)
AUTOMAX_LAYERS, AUTOMAX_BROWSERS, AUTOMAX_TAGSplaywright.config.tsselection passed from the CLI
AUTOMAX_RUN_ID, AUTOMAX_ARTIFACTS_DIRruntimerun identity and location (default .automax/runs)
AUTOMAX_CLI_OVERRIDESruntimeJSON of explicit CLI flags (set by the CLI)
AUTOMAX_LINTruntime1 during lint's undefined-step pass
AUTOMAX_UI_BASE_URL, AUTOMAX_API_BASE_URLconfigoverride base URLs
AUTOMAX_HEADED, AUTOMAX_WORKERS, AUTOMAX_SHARD, AUTOMAX_RETRIESconfigruntime overrides
AUTOMAX_SHOT_POLICY, AUTOMAX_SHOTS_ONLY_ON_FAILUREconfigscreenshot policy
AUTOMAX_HEALconfigenable or disable healing
AUTOMAX_HAR_MODE, AUTOMAX_OFFLINE, AUTOMAX_UPDATE_SNAPSHOTSconfigHAR mode, offline guard, baseline refresh
AUTOMAX_PROJECTS_DIRregistrywhere projects live (default projects)
AUTOMAX_LOG_LEVEL, AUTOMAX_LOG_JSON, AUTOMAX_DEBUGloggersilent, error, warn, info, step, debug; JSON lines; stack traces
AUTOMAX_ALLURE, AUTOMAX_INGESTruntimeextra reporter; force ingest
DB_DRIVER, DATABASE_URL, SQLITE_PATHdatabasedriver toggle
PORT, HOST, SESSION_SECRET, AUTOMAX_PUBLIC_URL, AUTH_DISABLED, AUTOMAX_MAX_CONCURRENT_RUNS, AUTOMAX_INGEST_MAX_MBserverweb server
AUTOMAX_SERVER_URL, AUTOMAX_TOKENCLIupload ingest through the server
AUTOMAX_LLM_PROVIDER, ANTHROPIC_API_KEY, OPENAI_BASE_URL, OPENAI_API_KEYagentsadapter selection and provider keys
GITHUB_TOKEN, JIRA_EMAIL, JIRA_API_TOKENintegrationsdefault secret names (configurable per project)
CIruntimeselects retries.ci