You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Alex Dunn 9490011226
helm: bump default image tag to v3.2.0 (#14476)
4 years ago
templates Add Helm chart (#14090) 4 years ago
.helmignore Add Helm chart (#14090) 4 years ago
Chart.yaml helm: bump chart and default image version to 3.1.5 (#14256) 4 years ago Add Helm chart (#14090) 4 years ago
values.yaml.template helm: bump default image tag to v3.2.0 (#14476) 4 years ago


This is a Helm chart for installing Mastodon into a Kubernetes cluster. The basic usage is:

cp values.yaml.template values.yaml
edit values.yaml # configure required settings
helm dep update
helm upgrade --install my-mastodon ./

This chart has been tested on Helm 3.0.1 and above.


The variables that must be configured are:

  • ingress.hostname; even if you aren’t using an Ingress, this value is used to set LOCAL_DOMAIN.

  • password and keys in the secrets, postgresql, and redis groups; if left blank, some of those values will be autogenerated, but will not persist across upgrades.

  • SMTP settings for your mailer in the smtp group.

Missing features

Currently this chart does not support:

  • Hidden services
  • S3/Minio/GCS
  • Single Sign-On
  • Swift
  • configurations using WEB_DOMAIN


Because database migrations are managed as a Job separate from the Rails and Sidekiq deployments, it’s possible they will occur in the wrong order. After upgrading Mastodon versions, it may sometimes be necessary to manually delete the Rails and Sidekiq pods so that they are recreated against the latest migration.