Skip to content

Configuration

Environment Variables

Here we cover environment variables used to configure the Server, Workers and CLI.

Server

Settings here apply to lyftdata run server and lyftdata run worker. Options without environment variables are omitted:

CLI/Environment VariableDefaultDescription
—staging-dir
LYFTDATA_STAGING_DIR
~/.local/lyftdataThe data/working directory
—auto-enrollment-key
LYFTDATA_AUTO_ENROLLMENT_KEY
noneThe shared secret for Worker enrollments
—bind-address
LYFTDATA_BIND_ADDRESS
127.0.0.1:3000The Server HTTP API will be served on this address and port. Use 0.0.0.0:3000 for all network interfaces
—disk-usage-max-percentage
LYFTDATA_DB_DISK_USE_MAX_PERCENT
80Logs and metric data will be removed when the staging directory volume exceeds this threshold
—jwt-psk
LYFTDATA_JWT_PSK
Auto-generatedPreshared JWT signing key
—log-retention-days
LYFTDATA_LOG_RETENTION_DAYS
30The maximum number of days that logs should be retained
—tls-cert
LYFTDATA_TLS_CERT
nonePath to TLS certificate file (if using TLS)
—tls-key
LYFTDATA_TLS_KEY
nonePath to TLS key (if using TLS)
n/a
LYFTDATA_LICENSE
noneUsed to provide the Server with a license key. If present, it will override existing licenses on every startup

Worker

Settings here apply to worker. Options without environment variables are omitted:

CLI/Environment VariableDefaultDescription
—lyftdata-worker-api-key
LYFTDATA_WORKER_API_KEY
n/aAPI key for this Worker
—lyftdata-worker-id
LYFTDATA_WORKER_ID
auto-generatedUnique ID. Used to identify this Worker
—worker-api-bind-address
LYFTDATA_WORKER_API_BIND_ADDRESS
127.0.0.1:4041
127.0.0.1:3041
Listening address for new internal job-worker protocol.
Port 3041 by default on the Server’s built-in Worker.
Otherwise 4041
—lyftdata-worker-name
LYFTDATA_WORKER_NAME
n/aName for this Worker
—lyftdata-url
LYFTDATA_URL
http://localhost:3000URL where the Server API can be reached
—auto-enrollment-key
LYFTDATA_AUTO_ENROLLMENT_KEY
n/aEnrollment secret if auto-enrollment is enabled on the Server
—jobs-dir
LYFTDATA_JOBS_DIR
n/aDirectory where jobs are stored, defaulting to user cache directory
—metrics-interval
LYFTDATA_WORKER_METRICS_INTERVAL
60Send metrics to Server at this interval (seconds)
—tags
LYFTDATA_WORKER_LABELS
n/aLabels to attach to Worker system information

CLI

Settings here apply to administrative commands. These commands are a CLI wrapper to the Server HTTP API:

Environment VariableDefaultDescription
LYFTDATA_URLhttp://localhost:3000Server URL