Skip to content

Kubernetes / Helm

Deploy mise-server to Kubernetes using the bundled Helm chart.

Basic Install

bash
helm install mise-server ./charts/mise-server \
  --set settings.authToken=your-secret-token \
  --set settings.baseUrl=https://mise-server.example.com \
  --set database.url=postgres://user:pass@host/mise_server

With External PostgreSQL Secret

bash
kubectl create secret generic mise-server-db \
  --from-literal=DATABASE_URL=postgres://user:pass@host/mise_server

helm install mise-server ./charts/mise-server \
  --set database.existingSecret=mise-server-db \
  --set settings.authToken=your-secret-token

With Bundled PostgreSQL

bash
helm install mise-server ./charts/mise-server \
  --set postgresql.enabled=true \
  --set postgresql.auth.password=secret \
  --set settings.authToken=your-secret-token

S3 Storage

yaml
# values.yaml
storage:
  s3:
    bucket: my-cache-bucket
    region: us-east-1
    accessKeyId: ...
    secretAccessKey: ...
  # Optional local disk read-through cache:
  # localCache:
  #   enabled: true
  #   maxBytes: 10737418240  # 10 GiB

Ingress

yaml
ingress:
  enabled: true
  className: nginx
  hosts:
    - host: mise-server.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: mise-server-tls
      hosts:
        - mise-server.example.com

Full Config File

yaml
config: |
  [settings]
  auth_token = "secret"
  base_url = "https://mise-server.example.com"

  [[users]]
  username = "alice"
  password_hash = "$argon2..."
  role = "admin"

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