← Blog

Deine eigene Mastodon-Instanz betreiben, Ende-zu-Ende verifiziert

Railyard

5. Oktober 2026 · 2 Min. Lesezeit

Deine eigene Ecke des Fediverse zu betreiben bedeutet, Mastodon selbst zu betreiben — das echte Upstream-Projekt, kein vereinfachter Klon, der es annähert. Das echte Mastodon hat echte Deployment-Anforderungen, die die meisten “Ein-Klick-Mastodon”-Angebote still und leise vereinfachen. Dieses hier nicht.

Was tatsächlich gebaut wird

Das Template baut direkt aus dem main-Branch von github.com/mastodon/mastodon.git, mit Mastodons eigenem Dockerfile — keine von Railyard gewartete Reimplementierung, die von Hand synchron gehalten werden muss, jedes Mal, wenn Upstream etwas ändert. Postgres und Redis werden als Addons bereitgestellt und automatisch verdrahtet, passend zu dem, was Mastodons eigene Setup-Dokumentation erwartet.

Verifiziert, nicht angenommen — dieses Template ist gegen ein echtes Deployment als verifiziert markiert, nicht nur aus Mastodons README geschrieben und gehofft, dass es funktioniert.

Die Secrets, die Mastodon tatsächlich braucht, korrekt generiert

Hier geht ein von Grund auf aufgesetztes Mastodon-Deployment üblicherweise schief, und hier zählt es mehr als fast überall sonst im Template-Katalog, es richtig zu machen: Mastodon hängt für Data at Rest von Active Record Encryption ab, was drei separate, korrekt generierte Keys braucht — ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY, _DETERMINISTIC_KEY und _KEY_DERIVATION_SALT — zusätzlich zu seinem eigenen SECRET_KEY_BASE und OTP_SECRET für die Zwei-Faktor-Authentifizierung. Ist einer davon falsch, inkonsistent oder fehlt, werden verschlüsselte Spalten unlesbar — kein sichtbarer Fehler beim Start, sondern eine Mine, die später hochgeht. Das Template generiert alle fünf gleich beim ersten Mal korrekt, nicht als nachträglicher Anbau an einen generischen “füge ein paar Env-Vars hinzu”-Flow.

Was weiterhin dir gehört

LOCAL_DOMAIN wird automatisch auf den eigenen Hostnamen der App gesetzt, und RAILS_SERVE_STATIC_FILES ist aktiviert, sodass Mastodon seine eigenen Assets ausliefert, ohne dass eine separate CDN-Schicht nötig ist, um anzufangen. Federation, Moderationseinstellungen und das tatsächliche Tagesgeschäft des Betriebs einer Instanz — wer sich anmelden darf, mit wem föderiert wird, wie Moderation funktioniert — sind Mastodons eigene Angelegenheiten, sobald es läuft, nicht etwas, worüber ein Deploy-Template stellvertretend entscheiden sollte.

Warum “verifiziert” der Punkt ist, kein Abzeichen

Eine Rails-App mit so vielen beweglichen Teilen (Postgres, Redis, ein Dockerfile-Build, fünf voneinander abhängige Secrets) hat viel Angriffsfläche für “funktioniert auf dem Happy Path, bricht beim ersten echten Konto”. Der Unterschied zwischen einem Template, das tatsächlich gestartet und geprüft wurde, und einem, das nur plausibel aussehende Konfiguration ist, zeigt sich genau dort, wo jemand versucht, seine erste verschlüsselte Spalte anzulegen.

Den vollständigen Katalog durchsuchen: Templates.

Starte Mastodon aus seinem eigenen Dockerfile.

Postgres und Redis automatisch bereitgestellt, Verschlüsselungs-Secrets korrekt generiert — ein Klick aus dem Template-Katalog.

Kostenloser Plan, keine Kreditkarte, und 14 Tage Pro für jedes neue Team. Ein fester Preis pro Team.