Server settings
lodebase-server reads these from the environment (each also works as a --flag). Generated from the server's --help.
| Variable | Default | Meaning |
|---|---|---|
LODEBASE_LISTEN | 0.0.0.0:7420 | Address to listen on (plain HTTP/2; terminate TLS at Traefik or similar) |
LODEBASE_DATABASE_URL | PostgreSQL connection string | |
LODEBASE_STORAGE | file:///var/lib/lodebase/objects | Object storage: file:///path or s3://bucket (AWS_* env for credentials/endpoint) |
LODEBASE_AUTH_MODE | oidc | oidc (authentik) or dev (trusts dev:<user> tokens; never in production) |
LODEBASE_OIDC_ISSUER | OIDC issuer, e.g. https://auth.example.com/application/o/lodebase/ | |
LODEBASE_OIDC_CLIENT_ID | Public client id the desktop daemon signs in with | |
LODEBASE_OIDC_AUDIENCE | Expected aud claim; defaults to the client id (authentik's default) | |
LODEBASE_ADMINS | "" | Users (name or OIDC subject) who administer every repo. Comma-separated |
LODEBASE_ADMIN_GROUPS | "" | authentik groups whose members administer every repo. Comma-separated |
LODEBASE_REPO_CREATION | everyone | Who may create repos: everyone or admins |
LODEBASE_DEFAULT_ROLE | contributor | Role everyone signed in gets on newly created repos (none, viewer, contributor, maintainer) |
LODEBASE_LOCK_STALE_HOURS | 72 | Hours without a workspace heartbeat before its locks show as stale |
LODEBASE_PUBLIC_URL | http://localhost:7420 | Public address of this server (the web UI's sign-in callback is <url>/auth/callback) |
LODEBASE_SECRETS_KEY | Master key for pipeline secrets: 32 bytes, base64 or hex (openssl rand -base64 32). Without it, secrets are disabled | |
LODEBASE_SECRETS_KEY_FILE | File holding the secrets key (e.g. a Docker secret) | |
LODEBASE_SHARED_MINUTES | 500 | Monthly shared runner minutes per repo (admins can change it per repo) |
LODEBASE_SHARED_JOB_MINUTES | 60 | Longest a single job may run on a shared runner, in minutes |
LODEBASE_POOLS_FILE | Autoscaled runner pools (YAML). Without it, no environments are started | |
LODEBASE_REPO_STORAGE_GB | 0 | Storage limit per repo in GiB, unless an org or repo says otherwise (0 = none) |
LODEBASE_ORG_STORAGE_GB | 0 | Storage limit per org (all its repos) in GiB, unless set for the org (0 = none) |
LODEBASE_USER_STORAGE_GB | 0 | Storage limit for each person's own repos together, in GiB (0 = none) |
LODEBASE_RETAIN_RUNS_DAYS | 90 | Days to keep finished pipeline runs (0 = forever; at least 32). Repos can override |
LODEBASE_RETAIN_ARTIFACTS_DAYS | 30 | Days to keep pipeline artifacts (0 = forever). The latest successful run's stay |
LODEBASE_RETAIN_LOGS_DAYS | 30 | Days to keep job logs (0 = forever) |
LODEBASE_CACHE_RETAIN_DAYS | 14 | Days a pool download cache may go unused before it is removed (0 = never) |
LODEBASE_GC_INTERVAL_HOURS | 24 | Hours between garbage collection runs (0 = only lode admin gc) |
LODEBASE_GC_GRACE_HOURS | 24 | Uploaded objects nothing references yet are kept at least this long (for submits in progress) |
LODEBASE_GC_SWEEP_STORAGE | true | List the object store for objects no repo recorded (refused or cut-off uploads) |
LODEBASE_SCHEDULER_TICK_SECS | 30 | How often schedules are checked and lost jobs are reaped, in seconds |
LODEBASE_OIDC_CLIENT_SECRET | Only for confidential OIDC clients; public clients use PKCE alone |
Also read from the environment
| Variable | Meaning |
|---|---|
LODEBASE_METRICS_TOKEN | Turns on /metrics (Prometheus format) for a scraper that sends it as a bearer token. Keep /metrics off your public proxy route. |
LODEBASE_STREAM_RECHECK_SECS | How often live event streams re-check that the subscriber still has access (default 30). |
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ENDPOINT_URL, AWS_REGION | Credentials and endpoint for s3:// storage (Garage, MinIO, R2, S3). |
RUST_LOG | Log level, e.g. info or lodebase_server=debug. |