Environment variables · Sextant docs

Settings are resolved in this order, highest first: flags, environment variables, config file, defaults. sextant config print shows the result.

Client variables

Read by the CLI and every SDK.

Variable	Default	Purpose
`SEXTANT_URL`	`http://127.0.0.1:7420`	Server base URL
`SEXTANT_TOKEN`	none	API token
`SEXTANT_PROFILE`	none	Profile saved by `sextant login` (CLI only)
`SEXTANT_TIMEOUT`	`30s`	Request timeout
`SEXTANT_TRACE_HEADER`	`1`	Set to `0` to stop sending `traceparent`
`NO_COLOR`	none	Disable colors in the CLI

Server and worker variables

Variable	Config key	Notes
`SEXTANT_CONFIG`		Path of the config file
`SEXTANT_LISTEN`	`server.listen`
`SEXTANT_STORE_DSN`	`store.dsn`	Keeps passwords out of the file
`SEXTANT_STORE_DRIVER`	`store.driver`
`SEXTANT_LOG_LEVEL`	`logging.level`
`SEXTANT_LOG_FORMAT`	`logging.format`
`SEXTANT_METRICS_LISTEN`	`metrics.listen`

Variables a command handler receives

sextant worker sets these when it runs an exec handler.

Variable	Example
`SEXTANT_JOB_ID`	`job_8f3k2m9q`
`SEXTANT_QUEUE`	`emails`
`SEXTANT_ATTEMPT`	`2`
`SEXTANT_MAX_ATTEMPTS`	`5`
`SEXTANT_RUN_AT`	`2026-10-20T09:15:00Z`
`TRACEPARENT`	`00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01`

Precedence example

Shell

# sextant.toml says logging.level = "info"
SEXTANT_LOG_LEVEL=warn sextant server                  # warn
SEXTANT_LOG_LEVEL=warn sextant server --log-level debug  # debug (flag wins)