Skip to content

Settings Reference

Complete reference for all mise-server.toml [settings] fields. All settings are auto-generated from settings.toml at build time.

Core

SettingTypeDefaultEnvDescription
portu163000MISE_SERVER_PORTPort to listen on
bindString0.0.0.0MISE_SERVER_BINDBind address
data_dirString./dataMISE_SERVER_DATA_DIRLocal storage directory
base_urlStringMISE_SERVER_BASE_URLExternal base URL
cache_ttlu64300MISE_SERVER_CACHE_TTLMetadata cache TTL (seconds)

Database

SettingTypeDefaultEnvDescription
database_urlStringDATABASE_URLPostgreSQL connection URL (required)

S3 Storage

SettingTypeDefaultEnvDescription
s3_bucketStringMISE_SERVER_S3_BUCKETS3 bucket name
s3_regionStringMISE_SERVER_S3_REGIONS3 region
s3_endpointStringMISE_SERVER_S3_ENDPOINTS3 endpoint URL
s3_prefixStringcache/MISE_SERVER_S3_PREFIXS3 key prefix
s3_local_cache_sizeu640MISE_SERVER_S3_LOCAL_CACHE_SIZELocal disk cache size (bytes)

Azure Storage

SettingTypeDefaultEnvDescription
azure_storage_accountStringMISE_SERVER_AZURE_STORAGE_ACCOUNTAzure account name
azure_storage_keyStringMISE_SERVER_AZURE_STORAGE_KEYAzure access key
azure_storage_containerStringcacheMISE_SERVER_AZURE_STORAGE_CONTAINERAzure container name

Authentication

SettingTypeDefaultEnvDescription
auth_tokenStringMISE_SERVER_AUTH_TOKENStatic bearer token
oidc_issuerStringMISE_SERVER_OIDC_ISSUEROIDC issuer URL
oidc_client_idStringMISE_SERVER_OIDC_CLIENT_IDOIDC client ID
oidc_client_secretStringMISE_SERVER_OIDC_CLIENT_SECRETOIDC client secret
oidc_token_ttlduration90dMISE_SERVER_OIDC_TOKEN_TTLOIDC token lifetime

Replication

SettingTypeDefaultEnvDescription
primary_urlStringMISE_SERVER_PRIMARY_URLPrimary instance URL
sync_intervalu6410MISE_SERVER_SYNC_INTERVALSync poll interval (seconds)

Security

SettingTypeDefaultEnvDescription
osv_fetchbooltrueMISE_SERVER_OSV_FETCHFetch OSV advisories
osv_refresh_intervalu6421600MISE_SERVER_OSV_REFRESH_INTERVALOSV refresh interval (seconds)
license_policy_enabledboolfalseMISE_SERVER_LICENSE_POLICY_ENABLEDEnable license enforcement
license_policy_unknown_actionStringallowMISE_SERVER_LICENSE_POLICY_UNKNOWN_ACTIONUnknown license action
license_cache_ttlu6486400MISE_SERVER_LICENSE_CACHE_TTLLicense cache TTL (seconds)

Multi-Tenancy

SettingTypeDefaultEnvDescription
hosted_domainStringMISE_SERVER_HOSTED_DOMAINBase domain for subdomain routing

Tokens

SettingTypeDefaultEnvDescription
github_tokenStringMISE_SERVER_GITHUB_TOKENGitHub API token
license_keyStringMISE_SERVER_LICENSE_KEYLicense key

Per-Registry Upstreams

All under [settings.piers.<registry>]:

SettingDefault
piers.npm.upstreamhttps://registry.npmjs.org
piers.pypi.upstreamhttps://pypi.org
piers.go.upstreamhttps://proxy.golang.org
piers.github.upstreamhttps://api.github.com
piers.rubygems.upstreamhttps://rubygems.org
piers.maven.upstreamhttps://repo1.maven.org/maven2
piers.apt.upstreamhttp://deb.debian.org/debian
piers.conda.upstreamhttps://conda.anaconda.org
piers.nuget.upstreamhttps://api.nuget.org/v3-flatcontainer
piers.helm.upstreamhttps://charts.helm.sh/stable
piers.cargo.upstreamhttps://index.crates.io
piers.docker.upstreamhttps://registry-1.docker.io
cargo_download_upstreamhttps://static.crates.io/crates

Licensed under FSL-1.1-ALv2. Maintained by @jdx.