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.

44 lines
1.2 KiB

  1. # Introduction
  2. This is a [Helm](https://helm.sh/) chart for installing Mastodon into a
  3. Kubernetes cluster. The basic usage is:
  4. ```
  5. cp values.yaml.template values.yaml
  6. edit values.yaml # configure required settings
  7. helm dep update
  8. helm upgrade --install my-mastodon ./
  9. ```
  10. This chart has been tested on Helm 3.0.1 and above.
  11. # Configuration
  12. The variables that _must_ be configured are:
  13. - `ingress.hostname`; even if you aren’t using an Ingress, this value is used to
  14. set `LOCAL_DOMAIN`.
  15. - password and keys in the `secrets`, `postgresql`, and `redis` groups; if
  16. left blank, some of those values will be autogenerated, but will not persist
  17. across upgrades.
  18. - SMTP settings for your mailer in the `smtp` group.
  19. # Missing features
  20. Currently this chart does _not_ support:
  21. - Hidden services
  22. - S3/Minio/GCS
  23. - Single Sign-On
  24. - Swift
  25. - configurations using `WEB_DOMAIN`
  26. # Upgrading
  27. Because database migrations are managed as a Job separate from the Rails and
  28. Sidekiq deployments, it’s possible they will occur in the wrong order. After
  29. upgrading Mastodon versions, it may sometimes be necessary to manually delete
  30. the Rails and Sidekiq pods so that they are recreated against the latest
  31. migration.