Zur Einrichtung von Tinybird für Ghost

1. Voraussetzungen auf dem Server

Kurzfassung:
Wenn deine Ghost-Instanz bereits mit der offiziellen Docker-Methode läuft, brauchst du in der Regel nichts zusätzlich „klassisch“ zu installieren – nur:

• Docker
• docker compose (oder docker-compose, je nach System)
• Zugriff auf deine Ghost-docker-compose.yml (oder das entsprechende Stack-File)

Tinybird selbst läuft als Managed Service in der Cloud. Auf deinem Server läuft nur ein kleiner Analytics-Proxy als zusätzlicher Container, der die Requests zu Tinybird weiterleitet.

2. Tinybird-Konto vorbereiten

1. Tinybird-Account anlegen / einloggen
   • In deinem Tinybird-Workspace anmelden.
2. Region merken
   • Notiere dir, in welcher Region dein Workspace läuft (z.B. https://api.us-east.tinybird.co oder ähnlich).
3. Auth Token erstellen
   • In Tinybird einen Admin- oder Workspace-Token erzeugen, der für Ghost Analytics gedacht ist.
   • Diesen Token brauchst du später als Umgebungsvariable im Docker-Setup.

Wichtig: Token wie ein Passwort behandeln – nicht ins Repo committen.

3. Ghost Docker-Setup verstehen

Die offizielle Ghost-Docker-Methode (Ghost 6.x) ist typischerweise so aufgebaut:

• Service ghost – dein eigentlicher Blog
• Reverse Proxy (z.B. Caddy oder nginx) – kümmert sich um HTTPS und Routing
• Optional: Analytics-Proxy-Service – leitet Traffic-Events an Tinybird weiter

Wenn du das „offizielle“ Docker-Setup von Ghost übernommen hast, gibt es meist schon vorbereitete Stellen für Analytics/Tinybird in der docker-compose.yml oder in einer .env-Datei.

4. Tinybird-Variablen in docker-compose.yml eintragen

Öffne auf deinem Server die Datei, mit der du Ghost startest, z.B.:

cd /pfad/zu/deinem/ghost-stack
nano docker-compose.yml

Du brauchst im Wesentlichen:

• Tinybird Host / Region
  z.B. TINYBIRD_HOST=https://api.us-east.tinybird.co
• Tinybird Token
  z.B. TINYBIRD_TOKEN=tb_your_long_token_here
• Flag, dass Analytics aktiviert sind
  z.B. GHOST_ANALYTICS_TINYBIRD_ENABLED=true (Name kann je nach Vorlage leicht variieren)

Typisch sieht das in einem Analytics-Proxy-Service so aus (Beispiel, anpassen an dein File):

services:
  ghost:
    image: ghost:6
    # ... dein bisheriges Setup ...
    environment:
      - url=https://bayerwald.blog
      # ggf. weitere Ghost-Variablen
      - GHOST_ANALYTICS_TINYBIRD_ENABLED=true

  analytics-proxy:
    image: ghostfoundation/analytics-proxy:latest
    environment:
      - TINYBIRD_HOST=https://api.us-east.tinybird.co
      - TINYBIRD_TOKEN=tb_your_long_token_here
    # falls nötig:
    # - PORT=8080
    # networks, depends_on etc. je nach Vorlage

Wenn dein offizielles Ghost-Docker-Setup bereits einen vorbereiteten analytics- oder tinybird-Service hat, musst du meist nur Host und Token ergänzen.

5. Reverse Proxy (Caddy/nginx) an Analytics-Proxy anbinden

Der Analytics-Proxy muss von außen erreichbar sein, damit dein Frontend (bayerwald.blog) die Tracking-Requests dorthin schicken kann.

Typisch passiert das so:

• Dein Reverse Proxy (z.B. Caddy/nginx) routet /ghost-analytics oder einen ähnlichen Pfad an den analytics-proxy-Container weiter.
• Der Proxy-Container schickt die Daten dann an Tinybird.

Beispiel (sehr vereinfacht, Caddy-Style):

bayerwald.blog {
    reverse_proxy /ghost-analytics analytics-proxy:8080
    # restliche Konfiguration für Ghost
}

Bei nginx wäre es ein location-Block, der auf den internen Container zeigt.
Wichtig ist nur: Der Browser deines Besuchers spricht mit deiner Domain, nicht direkt mit Tinybird.

6. Container neu starten

Wenn du docker-compose.yml oder .env geändert hast:

docker compose down
docker compose up -d

(oder docker-compose statt docker compose, je nach System)

Prüfen:

Gibt es Fehler im Log?

docker compose logs analytics-proxy

Läuft der neue analytics-proxy-Container?

docker compose ps

7. In Ghost Admin Analytics aktivieren und prüfen

1. In dein Ghost Admin von bayerwald.blog einloggen:
   https://ghostadmin.bayerwald.blog/ghost (oder dein Admin-Host).
2. In den Einstellungen nach dem Bereich Analytics suchen.
3. Sicherstellen, dass Web Analytics aktiviert sind (falls es einen Schalter gibt).
4. Ein paar Testaufrufe auf https://bayerwald.blog machen (am besten im Inkognito-Fenster).
5. Nach kurzer Zeit sollten im Ghost Admin unter Analytics erste Daten auftauchen.

8. Was du konkret noch tun musst

Zusammengefasst:

• Auf dem Server selbst:
  • Keine zusätzliche Software wie Node, Tinybird-CLI etc. nötig.
  • Nur dein bestehendes Docker-Setup anpassen.
• In der Konfiguration:
  1. Tinybird-Token im Tinybird-Dashboard erstellen.
  2. TINYBIRD_HOST und TINYBIRD_TOKEN in deiner docker-compose.yml (oder .env) eintragen.
  3. Analytics-Proxy-Service prüfen/ergänzen.
  4. Reverse Proxy so konfigurieren, dass er den Analytics-Pfad an den Proxy-Container weiterleitet.
  5. Stack neu starten, in Ghost Admin Analytics checken.