Environment Variables
All settings can be configured via environment variables. Most use the MISE_SERVER_ prefix.
Core Settings
| Variable | Default | Description |
|---|---|---|
DATABASE_URL | — | Required. PostgreSQL connection URL |
MISE_SERVER_PORT | 3000 | Port to listen on |
MISE_SERVER_BIND | 0.0.0.0 | Bind address |
MISE_SERVER_DATA_DIR | ./data | Local storage directory |
MISE_SERVER_AUTH_TOKEN | — | Static bearer token for auth |
MISE_SERVER_BASE_URL | — | Public URL (for reverse proxy) |
MISE_SERVER_CACHE_TTL | 300 | Metadata cache TTL (seconds) |
S3 Storage
| Variable | Default | Description |
|---|---|---|
MISE_SERVER_S3_BUCKET | — | S3 bucket name |
MISE_SERVER_S3_REGION | — | S3 region |
MISE_SERVER_S3_ENDPOINT | — | S3 endpoint (MinIO, R2, etc.) |
MISE_SERVER_S3_PREFIX | cache/ | S3 key prefix |
MISE_SERVER_S3_LOCAL_CACHE_SIZE | 0 | Local disk cache size (bytes, 0 = disabled) |
AWS_ACCESS_KEY_ID | — | S3 access key |
AWS_SECRET_ACCESS_KEY | — | S3 secret key |
Azure Blob Storage
| Variable | Default | Description |
|---|---|---|
MISE_SERVER_AZURE_STORAGE_ACCOUNT | — | Azure Storage account name |
MISE_SERVER_AZURE_STORAGE_KEY | — | Azure Storage access key |
MISE_SERVER_AZURE_STORAGE_CONTAINER | cache | Azure container name |
Authentication
| Variable | Default | Description |
|---|---|---|
MISE_SERVER_OIDC_ISSUER | — | OIDC discovery URL |
MISE_SERVER_OIDC_CLIENT_ID | — | OIDC client ID |
MISE_SERVER_OIDC_CLIENT_SECRET | ��� | OIDC client secret |
MISE_SERVER_OIDC_TOKEN_TTL | 90d | OIDC token lifetime |
Replication
| Variable | Default | Description |
|---|---|---|
MISE_SERVER_PRIMARY_URL | — | Primary instance URL (follower mode) |
MISE_SERVER_SYNC_INTERVAL | 10 | Sync poll interval (seconds) |
Security
| Variable | Default | Description |
|---|---|---|
MISE_SERVER_OSV_FETCH | true | Fetch OSV advisory database |
MISE_SERVER_OSV_REFRESH_INTERVAL | 21600 | OSV refresh interval (seconds) |
MISE_SERVER_LICENSE_POLICY_ENABLED | false | Enable license enforcement |
MISE_SERVER_LICENSE_POLICY_UNKNOWN_ACTION | allow | Unknown license action |
MISE_SERVER_LICENSE_CACHE_TTL | 86400 | License cache TTL (seconds) |
Multi-Tenancy
| Variable | Default | Description |
|---|---|---|
MISE_SERVER_HOSTED_DOMAIN | — | Base domain for subdomain routing |
Registry Tokens
| Variable | Description |
|---|---|
MISE_SERVER_GITHUB_TOKEN / GITHUB_TOKEN | GitHub API token |
MISE_SERVER_LICENSE_KEY | License key |
Per-Registry Upstreams
| Variable | Default |
|---|---|
MISE_SERVER_NPM_UPSTREAM | https://registry.npmjs.org |
MISE_SERVER_PYPI_UPSTREAM | https://pypi.org |
MISE_SERVER_GO_UPSTREAM | https://proxy.golang.org |
MISE_SERVER_GITHUB_UPSTREAM | https://api.github.com |
MISE_SERVER_RUBYGEMS_UPSTREAM | https://rubygems.org |
MISE_SERVER_MAVEN_UPSTREAM | https://repo1.maven.org/maven2 |
MISE_SERVER_APT_UPSTREAM | http://deb.debian.org/debian |
MISE_SERVER_CONDA_UPSTREAM | https://conda.anaconda.org |
MISE_SERVER_NUGET_UPSTREAM | https://api.nuget.org/v3-flatcontainer |
MISE_SERVER_HELM_UPSTREAM | https://charts.helm.sh/stable |
MISE_SERVER_CARGO_UPSTREAM | https://index.crates.io |
MISE_SERVER_DOCKER_UPSTREAM | https://registry-1.docker.io |
MISE_SERVER_CARGO_DOWNLOAD_UPSTREAM | https://static.crates.io/crates |
Logging
| Variable | Description |
|---|---|
RUST_LOG | Log verbosity (e.g. info, mise_server=debug) |