Zum Inhalt springen
Cockpit:engage Anleitung

Mastodon (Fediverse) verbinden

Cockpit verbindet alle Mastodon-API-kompatiblen Plattformen über einen einzigen Flow. Konkret unterstützt sind:

  • Mastodon (jede Instanz, ob mastodon.social, chaos.social, eine Vereins-Instanz oder eine selbst gehostete).
  • Pleroma und Akkoma (Mastodon-API-kompatibel).
  • Misskey (Mastodon-API-kompatibel ab v13).
  • Pixelfed.
  • Friendica.

Im Tool nennen wir den Bereich „Fediverse“. Auf der Verbindung-Karte steht „Fediverse-Account verbinden“ — unabhängig davon, welche Software eure Instanz tatsächlich betreibt. Der Flow ist immer derselbe.

Was ihr vorher braucht

  • Eine bestehende Account-Anmeldung auf eurer Fediverse- Instanz. Cockpit legt euch keinen neuen Account an — ihr meldet euch in der Instanz selbst an, wie ihr es ohne Cockpit machen würdet.
  • Die URL eurer Instanz, also die Adresse, unter der ihr euch einloggt. Beispiele: mastodon.social, chaos.social, troet.cafe, social.bund.de. Es reicht der Hostname; https:// ergänzt Cockpit selbst.

Falls ihr euren Account auf einer fremden Plattform habt (mastodon.online, mas.to etc.) — kein Problem, jede Mastodon-API-kompatible Instanz funktioniert.

Wie verbinden?

  1. Loggt euch als Manager ein.
  2. Sidebar → „Kanäle“ → „Fediverse-Account verbinden →“.
  3. Auf der Form „Fediverse-Account verbinden“ tragt ihr im Feld „Instanz-URL“ den Hostnamen eurer Instanz ein (z. B. mastodon.social).
  4. Klick auf „Verbinden“.
  5. Cockpit registriert sich einmalig als App auf eurer Instanz. Diesen Schritt seht ihr nicht — ihr werdet sofort zur Authentifizierungs-Weiterleitung gebracht.
  6. Auf der Authorize-Seite eurer Instanz prüft ihr, was Cockpit darf, und klickt auf „Authorize“ (oder das Equivalent in eurer Sprache und Software).
  7. Eure Instanz leitet euch zurück nach Cockpit. Ihr landet auf der Kanal-Übersicht und seht euren neu verbundenen Kanal mit grünem Status-Punkt.

Der ganze Flow dauert üblicherweise unter einer Minute. Wenn die Authorize-Seite eurer Instanz nicht erscheint, hilft meist ein zweiter Klick auf „Verbinden“ (manche Browser blockieren die Auto-Weiterleitung).

Welche Berechtigungen erteilt ihr?

Auf der Authorize-Seite eurer Instanz seht ihr eine Liste der Scopes, die Cockpit anfragt:

  • read — Cockpit kann Posts, Mentions und Kommentare abrufen, die euren Account erreichen.
  • write — Cockpit kann Posts unter eurem Account veröffentlichen.

DMs und Follow-Listen werden nicht angefordert. Cockpit liest also weder eure Folgen-Liste noch private Chats.

Häufige Fragen

Was ist der Unterschied zwischen Mastodon und Fediverse? Das Fediverse ist das Netzwerk der vielen kleinen Server, die über das ActivityPub-Protokoll miteinander reden — Mastodon ist eine Software, die in diesem Netzwerk läuft. Cockpit verbindet jede Mastodon-API-kompatible Software, deshalb heißt die Karte „Fediverse-Account verbinden“.

Welche Instanz-URL trage ich ein, wenn meine Adresse @user@chaos.social lautet? Den Domain-Teil: chaos.social. Den @user-Teil bekommt Cockpit automatisch im OAuth-Callback.

Cockpit sagt, die Instanz sei nicht erreichbar — was tun? Drei Möglichkeiten:

  1. Tippfehler in der URL. Korrigiert die Schreibweise.
  2. Instanz aktuell down. Versucht es ein paar Minuten später.
  3. Instanz-Firewall blockiert die App-Registrierung. Sehr selten — schreibt eurer Instanz-Administration. Diese kann die Cockpit-IP-Adresse in der Firewall freischalten.

Mein Token ist nach Wochen abgelaufen — neu verbinden, oder gibt es Re-Auth? Mastodon-Tokens haben technisch keine Ablaufzeit. Wenn Cockpit „expiriert“ meldet, ist meist der App-Eintrag in eurer Instanz gelöscht worden (z. B. von einer Admin-Aufräumaktion). Pfad: Trennen + neu verbinden.

Können wir mehrere Mastodon-Accounts verbinden? Ja, beliebig viele — auch in derselben Untereinheit, solange es unterschiedliche Accounts sind (z. B. ein Haupt-Account plus ein Themen-spezifischer Nebenaccount). Pro Account-und-Untereinheit- Kombination prüft Cockpit auf Eindeutigkeit, damit ihr nicht versehentlich denselben Account doppelt verbindet.

Funktioniert das auch mit der Bundes-Instanz social.bund.de? Ja, sofern die Instanz Mastodon (oder eine API-kompatible Software) betreibt und die OAuth-App-Registrierung nicht durch eine Whitelist eingeschränkt ist. Im Zweifel: einfach probieren, und falls die Verbindung fehlschlägt, Instanz-Administration kontaktieren.