Publit.Si
Dokumentation›Publit.Si starten

Installation

Publit.Si starten

Publit.Si besteht aus vier kleinen Diensten: der App, dem Veröffentlichungsdienst, dem Gateway und dem Tunnel. Starte sie automatisch mit deinem Computer oder von Hand.

Automatisch starten (empfohlen)

  1. Im Ordner publitsi:

    pnpm ops:install
  2. Der Befehl baut die App und startet alles bei jeder Anmeldung. Sobald Publit.Si bereit ist, öffnet sich localhost:3000.

  3. Mac: LaunchAgents. Windows: Aufgaben im Ordner PublitSi der Aufgabenplanung, die ohne Fenster laufen und nach Abstürzen neu starten. Linux: systemd-Benutzerdienste; prüfe sie mit systemctl --user status 'publitsi-*'.

  4. Mit pnpm ops:uninstall entfernst du den Autostart wieder.

Oder von Hand starten

  1. Starte pnpm dev, öffne localhost:3000, gehe zu Settings › Status und klicke auf Start all (alle starten).

Status prüfen

  1. Settings › Status zeigt Veröffentlichungsdienst, Gateway und Tunnel. Sind alle grün, kann Publit.Si veröffentlichen.

    Publit.Si, Settings › Status: Worker, Gateway (local) und Public URL (tunnel) mit grünen Punkten
    1. 1:Worker (Veröffentlichungsdienst)
    2. 2:Public URL (tunnel): öffentlicher Tunnel
    Settings › Status: Veröffentlichungsdienst, Gateway und Tunnel sind grün. Nur mit YouTube darf der Tunnel aus bleiben.
  2. Auf dem Mac fragt die erste Mitteilung, ob „PublitSi“ Benachrichtigungen senden darf. Klicke auf Allow (erlauben).

  3. Du möchtest dich zuerst umsehen? Die Übersicht bietet Explore with demo data (mit Beispieldaten erkunden). Dabei wird nichts wirklich veröffentlicht; Remove demo entfernt die Beispieldaten.

Optional

Einen anderen Port verwenden

Publit.Si öffnet sich auf Port 3000. Belegt ein anderes Programm diesen Port, wähle in der App einen anderen.

  1. Öffne [127.0.0.1:3000](http://127.0.0.1:3000), danach Settings › General › Address (Adresse).

  2. Trage einen freien Port von 1024 bis 65535 ein und klicke auf Save and restart (speichern und neu starten).

  3. Publit.Si speichert den Port und startet neu. Die Seite wechselt automatisch zur neuen Adresse. Benachrichtigungen und Anmeldungen nutzen die neue Adresse.

  4. YouTube und die Search Console des Blogs melden sich über diese Adresse an. Aktualisiere ihre Weiterleitungsadressen in Google Cloud; Settings › Platform setup zeigt die neuen Werte.

Ergebnis prüfen

Settings › Status zeigt Veröffentlichungsdienst, Gateway und Tunnel grün (nur YouTube: Der Tunnel darf aus bleiben). Nach Änderungen an .env führe pnpm ops:install erneut aus.

Fehlersuche

Windows: pnpm ops:install kann keine Aufgabe erstellen
Führe den Befehl in einer normalen, nicht als Administrator gestarteten PowerShell unter dem Benutzer aus, der Publit.Si ausführen soll.
Linux: systemctl --user meldet „Failed to connect to bus“
Melde dich direkt als dieser Benutzer an (Desktop oder ssh user@server), nicht über su/sudo -u. Proxmox/LXC: pct enter meldet als root an. Erstelle einen normalen Benutzer und melde dich mit ihm per SSH an (siehe „Linux-Server“). Ohne systemd starte pnpm dev und pnpm services selbst, etwa in tmux.
Linux: Dienste enden beim Abmelden oder starten nach Neustart nicht
Führe einmal sudo loginctl enable-linger $USER aus (SETUP.md, Schritt 7).
Migration meldet eine belegte Datenbank
Stoppe pnpm dev und schließe alte Sitzungen von Claude Code, Codex, Cursor oder OpenCode. Der Befehl listet die Prozesse.
localhost:3000 zeigt „404 – not found“ oder eine andere App
Ein anderes Programm belegt ebenfalls Port 3000. Öffne http://127.0.0.1:3000 und wähle unter Settings › General › Address einen anderen Port. Publit.Si startet dort neu. Bei Autostart von vor v1.6.1 führe einmal pnpm ops:install aus. Aktualisiere anschließend die YouTube- und Search-Console-Weiterleitungsadressen in Google Cloud.
Tunnel bleibt rot
Prüfe ~/.cloudflared/publitsi.yml (UUID, Zugangsdaten-Datei, Hostname) und PUBLITSI_PUBLIC_URL. Bei Tailscale Funnel muss tailscale funnel status Port 3100 und dieselbe Adresse wie PUBLITSI_PUBLIC_URL zeigen.

Du kommst nicht weiter? Suche in der Fehlersuche oder schreibe uns . Teile keine Zugangsdaten oder Tokens.