chart

github.com/mastodon/chart Fediverse Open-source projectOpen source

Deploy Mastodon on Kubernetes with the project’s Helm chart for cluster installations.

github.com/mastodon/chart
chart homepage screenshot

About chart

This repository provides a Helm chart for installing Mastodon into a Kubernetes cluster. It uses values.yaml files for custom settings, with documented install commands, and is tested with Kubernetes 1.21+ and Helm 3.8.0+.

The chart is deprecated as of Mastodon v4.6.0 and will not receive new features, with Mastodon release updates continuing only until 2026-12-31. Use requires configuring secrets, PostgreSQL, Redis and SMTP settings, and it does not support hidden services or Swift.

Key features

  • Installs Mastodon into a Kubernetes cluster using Helm
  • Supports custom configuration through values.yaml files
  • Configures passwords and keys for Mastodon, PostgreSQL, Redis
  • Configures SMTP mailer settings for Mastodon
  • Runs tootctl admin commands in web deployment via kubectl
  • Sets pod affinity to co-locate web and Sidekiq pods
Best for: Operators deploying and maintaining a Mastodon instance on a Kubernetes cluster.
Good for
  • Tested with Kubernetes 1.21+ and Helm 3.8.0+
  • Supports separate values files for custom configuration
  • Open source under AGPL-3.0 license
Watch out for
  • Deprecated since Mastodon v4.6.0; release updates end 2026-12-31
  • Does not support hidden services or Swift
  • Upgrades may require manual deletion of Rails and Sidekiq pods

chart at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

chart alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

phanpy

github.com/cheeaun/phanpy

Access Mastodon through Phanpy, a minimalistic web client described by its project repository.

Open source
24 alternatives

Popular in Fediverse

Well-known listings from the same topic.

All 113

chart FAQ

Is this chart deprecated?
Yes. As of Mastodon v4.6.0 it receives no new features and will receive Mastodon release updates only until 2026-12-31; the project directs users to the new Helm chart and migration guide.
What must be configured to install?
Passwords and keys in the mastodon.secrets, postgresql and redis groups, and SMTP settings in the mastodon.smtp group; blank secret values are autogenerated but do not persist across upgrades.
How do I run admin commands?
Use kubectl to execute in the web deployment, for example kubectl -n mastodon exec -it deployment/mastodon-web -- tootctl accounts modify admin --reset-password.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing