Settings Reference
Complete reference for all mise-server.toml [settings] fields. All settings are auto-generated from settings.toml at build time.
Core
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
port | u16 | 3000 | MISE_SERVER_PORT | Port to listen on |
bind | String | 0.0.0.0 | MISE_SERVER_BIND | Bind address |
data_dir | String | ./data | MISE_SERVER_DATA_DIR | Local storage directory |
base_url | String | — | MISE_SERVER_BASE_URL | External base URL |
cache_ttl | u64 | 300 | MISE_SERVER_CACHE_TTL | Metadata cache TTL (seconds) |
Database
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
database_url | String | — | DATABASE_URL | PostgreSQL connection URL (required) |
S3 Storage
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
s3_bucket | String | — | MISE_SERVER_S3_BUCKET | S3 bucket name |
s3_region | String | — | MISE_SERVER_S3_REGION | S3 region |
s3_endpoint | String | — | MISE_SERVER_S3_ENDPOINT | S3 endpoint URL |
s3_prefix | String | cache/ | MISE_SERVER_S3_PREFIX | S3 key prefix |
s3_local_cache_size | u64 | 0 | MISE_SERVER_S3_LOCAL_CACHE_SIZE | Local disk cache size (bytes) |
Azure Storage
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
azure_storage_account | String | — | MISE_SERVER_AZURE_STORAGE_ACCOUNT | Azure account name |
azure_storage_key | String | — | MISE_SERVER_AZURE_STORAGE_KEY | Azure access key |
azure_storage_container | String | cache | MISE_SERVER_AZURE_STORAGE_CONTAINER | Azure container name |
Authentication
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
auth_token | String | — | MISE_SERVER_AUTH_TOKEN | Static bearer token |
oidc_issuer | String | — | MISE_SERVER_OIDC_ISSUER | OIDC issuer URL |
oidc_client_id | String | — | MISE_SERVER_OIDC_CLIENT_ID | OIDC client ID |
oidc_client_secret | String | — | MISE_SERVER_OIDC_CLIENT_SECRET | OIDC client secret |
oidc_token_ttl | duration | 90d | MISE_SERVER_OIDC_TOKEN_TTL | OIDC token lifetime |
Replication
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
primary_url | String | — | MISE_SERVER_PRIMARY_URL | Primary instance URL |
sync_interval | u64 | 10 | MISE_SERVER_SYNC_INTERVAL | Sync poll interval (seconds) |
Security
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
osv_fetch | bool | true | MISE_SERVER_OSV_FETCH | Fetch OSV advisories |
osv_refresh_interval | u64 | 21600 | MISE_SERVER_OSV_REFRESH_INTERVAL | OSV refresh interval (seconds) |
license_policy_enabled | bool | false | MISE_SERVER_LICENSE_POLICY_ENABLED | Enable license enforcement |
license_policy_unknown_action | String | allow | MISE_SERVER_LICENSE_POLICY_UNKNOWN_ACTION | Unknown license action |
license_cache_ttl | u64 | 86400 | MISE_SERVER_LICENSE_CACHE_TTL | License cache TTL (seconds) |
Multi-Tenancy
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
hosted_domain | String | — | MISE_SERVER_HOSTED_DOMAIN | Base domain for subdomain routing |
Tokens
| Setting | Type | Default | Env | Description |
|---|---|---|---|---|
github_token | String | — | MISE_SERVER_GITHUB_TOKEN | GitHub API token |
license_key | String | — | MISE_SERVER_LICENSE_KEY | License key |
Per-Registry Upstreams
All under [settings.piers.<registry>]:
| Setting | Default |
|---|---|
piers.npm.upstream | https://registry.npmjs.org |
piers.pypi.upstream | https://pypi.org |
piers.go.upstream | https://proxy.golang.org |
piers.github.upstream | https://api.github.com |
piers.rubygems.upstream | https://rubygems.org |
piers.maven.upstream | https://repo1.maven.org/maven2 |
piers.apt.upstream | http://deb.debian.org/debian |
piers.conda.upstream | https://conda.anaconda.org |
piers.nuget.upstream | https://api.nuget.org/v3-flatcontainer |
piers.helm.upstream | https://charts.helm.sh/stable |
piers.cargo.upstream | https://index.crates.io |
piers.docker.upstream | https://registry-1.docker.io |
cargo_download_upstream | https://static.crates.io/crates |