SDODS
Reference

Environment variables

Every variable SDODS reads.

VariableUsed byMeaning
SDODS_PROJECT, SDODS_ENVruntimeproject and environment selection (run sets them for workers)
SDODS_LAYERS, SDODS_BROWSERS, SDODS_TAGSsdods.runner.config.tsselection passed from the CLI
SDODS_RUN_ID, SDODS_ARTIFACTS_DIRruntimerun identity and location (default .sdods/runs)
SDODS_CLI_OVERRIDESruntimeJSON of explicit CLI flags (set by the CLI)
SDODS_LINTruntime1 during lint's undefined-step pass
SDODS_UI_BASE_URL, SDODS_API_BASE_URLconfigoverride base URLs
SDODS_HEADED, SDODS_WORKERS, SDODS_SHARD, SDODS_RETRIESconfigruntime overrides
SDODS_SHOT_POLICY, SDODS_SHOTS_ONLY_ON_FAILUREconfigscreenshot policy
SDODS_HEALconfigenable or disable healing
SDODS_TRACE, SDODS_VIDEOconfigPlaywright trace and video modes (evidence.trace, evidence.video)
SDODS_HAR_MODE, SDODS_OFFLINE, SDODS_UPDATE_SNAPSHOTSconfigHAR mode, offline guard, baseline refresh
SDODS_PROJECTS_DIRregistrywhere projects live (default projects)
SDODS_LOG_LEVEL, SDODS_LOG_JSON, SDODS_DEBUGloggersilent, error, warn, info, step, debug; JSON lines; stack traces
SDODS_ALLURE, SDODS_INGESTruntimeextra reporter; force ingest
SDODS_AUTO_INSTALL_BROWSERSruntime1: sdods run downloads missing test browsers first (same as --install-browsers; set by the desktop app)
DB_DRIVER, DATABASE_URL, SQLITE_PATHdatabasedriver toggle
PORT, HOST, SESSION_SECRET, SDODS_PUBLIC_URL, AUTH_DISABLED, SDODS_MAX_CONCURRENT_RUNS, SDODS_INGEST_MAX_MBserverweb server
SDODS_SERVER_URL, SDODS_TOKENCLIupload ingest through the server
SDODS_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

Using an AI coding agent? Install SDODS:

Install the SDODS plugin in Claude Code: skills, subagents, commands and the MCP server.

  1. /plugin marketplace add YarlisAISolutions/sdods-skills
  2. /plugin install sdods@sdods
Learn more about using SDODS with AI tools