Umgebungsvariablen

Name der Datenbank, die PostgreSQL beim ersten Start anlegt. Frei wählbar. Sie wird nur beim Anlegen des Datenverzeichnisses ausgewertet.

Datenbankbenutzer, wird beim ersten Start angelegt und ist Superuser der Datenbank.

Passwort des Datenbankbenutzers. Wähle ein starkes, zufälliges Passwort und lass den Beispielwert change-me nicht stehen. Das Passwort wird nur beim Anlegen des Datenverzeichnisses gesetzt. Um es in einer bestehenden Datenbank zu ändern, brauchst du ein ALTER USER in PostgreSQL.

Verbindungszeichenfolge, über die FediSuite die Datenbank erreicht. Format: postgresql://BENUTZER:PASSWORT@HOSTNAME:PORT/DATENBANK. Der Hostname ist db, so heißt der Datenbankcontainer im Docker-Netzwerk. Benutzer, Passwort und Datenbankname müssen den POSTGRES_*-Werten entsprechen. Sonderzeichen im Passwort (zum Beispiel @, / oder :) müssen URL-kodiert werden. Am einfachsten ist ein Passwort aus Buchstaben und Ziffern.

Die vollständige öffentliche URL deiner Instanz, mit https:// und ohne abschließenden Schrägstrich. FediSuite baut daraus Links in E-Mails und die OAuth-Rückkehradresse (APP_URL/api/auth/fediverse/callback). Stimmt sie nicht mit der echten Domain überein, schlägt das Verbinden von Konten fehl. Ohne Angabe gilt http://localhost:3000.

Geheimer Schlüssel, mit dem FediSuite Login-Tokens signiert. Er verschlüsselt außerdem die gespeicherten Zwei-Faktor-Geheimnisse und das Geheimnis für das Instanzverzeichnis. Wer ihn kennt, kann Tokens fälschen. Er muss deshalb lang, zufällig und geheim sein. FediSuite verlangt keine Mindestlänge, ohne den Wert startet der Prozess aber nicht. Ändere ihn nach dem Start nicht mehr: Alle Logins werden ungültig, und gespeicherte Zwei-Faktor-Geheimnisse lassen sich nicht mehr entschlüsseln.

openssl rand -hex 64

Eigener 32-Byte-Schlüssel für die Verschlüsselung von Zugangstokens und Client-Secrets verbundener Fediverse-Konten. Er muss aus genau 64 Hex-Zeichen bestehen, unabhängig vom JWT_SECRET sein und bei App und Workern identisch ankommen. Erzeuge ihn einmalig mit openssl rand -hex 32, trage ihn in .env ein und sichere ihn getrennt und verschlüsselt. Beim ersten 2.0-Start werden vorhandene Zugangsdaten migriert. Ein fehlender, ungültiger oder falscher Schlüssel verhindert den Start beziehungsweise das Entschlüsseln; nach der Migration darfst du ihn nicht austauschen.

Anzeigename der Instanz, zum Beispiel in E-Mails und im Standard-User-Agent. Standard: FediSuite.

Öffentliche Adresse der Instanz für den Standard-User-Agent und den Eintrag im Instanzverzeichnis. Standard: der Wert von APP_URL. In den meisten Fällen kannst du sie weglassen oder gleich APP_URL setzen.

Hostname des SMTP-Servers deines E-Mail-Anbieters. Ohne Angabe verwendet FediSuite localhost.

Port des SMTP-Servers. Bei 465 verwendet FediSuite sofort TLS. Bei jedem anderen Port, zum Beispiel 587, wird die Verbindung per STARTTLS verschlüsselt, sofern der Server es anbietet. Ohne Angabe gilt 1025.

Benutzername für die SMTP-Anmeldung, oft die Absenderadresse.

Passwort für die SMTP-Anmeldung. Manche Anbieter verlangen ein eigenes App-Passwort statt des Konto-Passworts.

Absenderadresse der E-Mails. Sie muss in der Regel zur Domain deines SMTP-Kontos passen, sonst lehnen Empfangsserver die Mails ab. Ohne Angabe nutzt FediSuite "APP_NAME" <no-reply@HOST> mit dem Host aus APP_URL.

Steuert, ob sich neue Nutzer*innen über die Registrierungsseite anmelden können. Standard ist true (offen). Für eine private Instanz setzt du false.

User-Agent-Header für alle ausgehenden HTTP-Anfragen, etwa an Fediverse-Server. Standard: Mozilla/5.0 (compatible; APP_NAME/1.0; +PUBLIC_SITE_URL). Mit einer erreichbaren URL im Header können Betreiber*innen fremder Instanzen dich bei Problemen kontaktieren.

OUTBOUND_HTTP_USER_AGENT=Mozilla/5.0 (compatible; FediSuite/1.0; +https://deine-domain.de)

Anzahl vertrauenswürdiger Reverse-Proxys vor der App. Sie bestimmt die Client-IP für Rate-Limits, Audit-Logs und Sitzungen. Bei direkt erreichbarem Port 3000 0 setzen; hinter genau einem vertrauenswürdigen Proxy wie Traefik 1. Der Server akzeptiert auch false, true oder eine kommagetrennte Liste vertrauenswürdiger Adressen/Netze. true bei direktem Zugriff vermeiden: Clients könnten ihre IP über Weiterleitungs-Header fälschen.

Standardmäßig verweigert FediSuite Verbindungen in private Netze (Loopback, private Adressbereiche, Link-Local-Adressen wie der Cloud-Metadatendienst). Die Prüfung läuft bei jedem Verbindungsaufbau, auch bei Weiterleitungen. Setze true nur, wenn eine verbundene Instanz in deinem eigenen Netz läuft, etwa eine Testinstanz neben dem Server. Auf Servern, die nur öffentliche Instanzen anbinden, lässt du die Variable ungesetzt.

Allgemeines Zeitlimit in Millisekunden für ausgehende HTTP-Anfragen (mindestens 1000). Einzelne Abläufe wie die Reichweiten-Berechnung setzen kürzere eigene Limits.

Entwürfe: Beiträge ohne Zeitpunkt, die der Scheduler nie veröffentlicht, mit Phase (Idee, in Arbeit, bereit) und Entwurfs-Tab bei den Beiträgen.

Content-Kalender: Monats- und Wochenansicht der Beiträge mit Filtern und Verschieben per Drag-and-drop.

Labels und Kampagnen: interne Markierungen für Beiträge, die nie veröffentlicht oder zu Hashtags werden.

Wiederverwendung: Archivbeiträge als neuen Entwurf übernehmen, Hinweis „Wieder interessant“, Evergreen-Sammlung und Warnung vor ähnlichen Beiträgen.

Inhaltsanalyse: Tab „Inhalte“ in der Analyse, Hinweise im Composer und Zeitfenster-Markierungen im Kalender.

Zeigt die Community-Analyse und aktiviert ihre API. Sie unterscheidet interagierende, neue und wiederkehrende Konten anhand gespeicherter Interaktionen. Mit false wird die Funktion ausgeblendet; die Aufbewahrung der Interaktionsdaten regelt separat ENGAGEMENT_RETENTION_DAYS.

Veröffentlicht fällige geplante Beiträge (jede Minute) und gleicht, falls veröffentlicht, die Instanzliste ab. In der Compose-Datei nur in worker1 an. Mehrere Scheduler würden Beiträge nicht doppelt posten (jeder Beitrag wird atomar beansprucht), sind aber überflüssig.

Aktualisiert regelmäßig Konten und Beitragszahlen. Kann in mehreren Containern laufen.

Arbeitet die Warteschlange für die Reichweiten-Berechnung ab. Die Compose-Datei setzt es nicht, daher läuft es in jedem Container.

Sendet die einmalige Erinnerung an Nutzer*innen, die nach 48 Stunden noch kein Fediverse-Konto verbunden haben. In der Compose-Datei nur in worker1 an.

Erzeugt alle sechs Stunden die Tipps für verbundene Konten. Kann in mehreren Containern laufen.

Eindeutiger Name des Containers, zum Beispiel worker-1. Er erscheint in den Logs und bei Sperren und Warteschlangen.

Wie viele Konten ein Worker pro Durchlauf (alle 60 Sekunden) aktualisiert, 1 bis 50. Die Compose-Datei setzt 5. Niedrigere Werte schonen die Server der Fediverse-Instanzen, höhere arbeiten viele Konten schneller ab.

Schaltet das Plugin-System ein oder aus. Bei false bleibt die Plugin-Registry leer.

Durchsucht beim Start den Ordner /app/plugins nach Plugins. Bei false wird der Scan übersprungen.

Plugin-API-Version der Instanz. Plugins deklarieren in ihrer plugin.json, mit welcher Version sie laufen. Lass den Wert bei 1.

Aufbewahrungsdauer für Interaktionen anderer Fediverse-Konten in der Community-Analyse. Eine stündliche Bereinigung entfernt ältere Datensätze in Batches; eine kürzere Frist verkürzt auch die auswertbare Historie. Ungültige Werte fallen auf 730 Tage zurück, Werte außerhalb des Bereichs werden begrenzt. Die Frist sollte zur Datenschutzerklärung passen.

Ältere Changelog-Einträge erwähnen diese Variable, aktuelle Images ignorieren sie jedoch. Das Plugin-Verzeichnis ist fest /app/plugins. Das Plugin-Repository in allen App- und Worker-Containern dort einbinden; PLUGINS_ENABLED und PLUGIN_SCAN_ON_START steuern das Laden.