Ghost® auf einem Managed VPS hosten: Ihre Publikation auf Ihrem Server

Was Ghost kann

Ghost ist eine professionelle, freie Publishing-Plattform, geschrieben für Node.js. Sie vereint an einem Ort, was eine unabhängige Publikation sonst oft aus mehreren Werkzeugen zusammensetzt.

• Die Publikation: Artikel, Seiten, anpassbare Themes, integrierte SEO-Funktionen und eine Domain auf Ihren Namen.
• Die Mitglieder: Registrierung und Anmeldung per Link, der per E-Mail kommt, ohne Passwort, und Inhalte, die je nach Stufe des Mitglieds vorbehalten sind.
• Die kostenpflichtigen Abos: ein mit Ihrer Website verbundenes Stripe-Konto, um Ihre Tarife zu verkaufen.
• Die Newsletter: Jeder Artikel kann per E-Mail an Ihre kostenlosen oder zahlenden Mitglieder oder an ein Segment gehen, mit einem oder mehreren Newslettern.
• Die APIs: eine native REST-API, um eine maßgeschneiderte Website oder Ihre eigenen Werkzeuge anzubinden.

Laut der Dokumentation hat das Produkt beim Selbsthosting dieselben Funktionen. Was darum herum liegt, fällt Ihnen zu: der Versand der Newsletter, die Web-Analytics, ein CDN und die vollständigen Backups der Website.

Die MIT-Lizenz und die Marke

Ghost wird unter der MIT-Lizenz veröffentlicht. Sie erlaubt, die Software zu nutzen, zu kopieren, zu ändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, unterzulizenzieren und zu verkaufen, unter einer Bedingung: der Copyright-Hinweis und der Lizenztext bleiben in jeder Kopie erhalten. Sie können Ghost also im Unternehmen betreiben, anpassen und dort für Ihre Kunden veröffentlichen, ohne eine Lizenz zu kaufen.

Die Lizenz deckt den Code ab. Name und Logo gehören der Ghost Foundation und unterliegen ihrer Markenrichtlinie: Lesen Sie sie, wenn Sie rund um die Software ein Angebot aufbauen. Ghost ist eine eingetragene Marke der Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Auf Deutsch: Diese Publikation ist unabhängig von der Ghost Foundation und steht weder in Verbindung mit ihr noch ist sie von ihr autorisiert, gesponsert oder genehmigt.

Ghost-CLI oder Docker Compose: zwei offizielle Methoden

Das Projekt dokumentiert zwei Wege für die Produktion. Ghost-CLI ist die Installation, die es offiziell empfiehlt, und Docker Compose ist eine „Preview“, die es als ganz neu bezeichnet. Es gibt außerdem an, auf diese Docker-Werkzeuge zuzugehen, statt Ghost-CLI weiterzuentwickeln, und liefert einen Assistenten für den Wechsel von der einen zur anderen.

Bevor Sie beginnen: die Domain und der Server

Lassen Sie die Domain vor der Installation auf den Server zeigen: Das Zertifikat wird während der Einrichtung ausgestellt. Auf einem Simafri-VPS kommen die Besucher über die Ports 80 und 443 an, unter dem Domainnamen des Servers, mit A- und AAAA-Einträgen. Die Adresse der Website wird vollständig mit ihrem Protokoll geschrieben, etwa https://example.com: Eine IP-Adresse führt zu Fehlern.

Über den oben genannten Arbeitsspeicher hinaus nennt das Projekt weder Festplatte noch Last: Die Größe hängt von Ihrem Traffic, Ihren Bildern und Ihren Medien ab. Auf einem Managed VPS beschreiben Sie uns Ihre Publikation, und wir empfehlen Ihnen die passende Größe.

Ghost mit Ghost-CLI unter Ubuntu installieren

Ghost-CLI wird mit einem Benutzer verwendet, der nicht root ist und nicht ghost heißt, denn dieser Name kollidiert mit dem Werkzeug. Legen Sie ihn vom Konto root aus an und ersetzen Sie user durch den gewählten Namen:

adduser <user>
usermod -aG sudo <user>
su - <user>

Nginx und MySQL

Aktualisieren Sie das System und installieren Sie Nginx (mindestens 1.9.5 für SSL) und MySQL. Die Zeile ufw öffnet HTTP und HTTPS, falls diese Firewall aktiv ist:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install nginx
sudo ufw allow 'Nginx Full'
sudo apt-get install mysql-server

Auf neueren Ubuntu-Versionen authentifiziert sich das MySQL-Konto root über einen Socket, was Ghost nicht unterstützt. Geben Sie ihm ein Passwort:

sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED WITH 'caching_sha2_password' BY '<your-new-root-password>';
FLUSH PRIVILEGES;
exit

Node.js und Ghost-CLI

Ghost verlangt Node.js 22: Die Versionen 20, 21, 23 und höher werden nicht unterstützt. Das Projekt verlangt, es systemweit zu installieren, und zwar so:

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
NODE_MAJOR=22
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt-get update
sudo apt-get install nodejs -y
sudo npm install ghost-cli@latest -g

Die Installation starten

Ghost wird in einem eigenen Ordner installiert, mit einem bestimmten Eigentümer und bestimmten Rechten. Ersetzen Sie sitename durch einen Namen Ihrer Wahl:

sudo mkdir -p /var/www/sitename
sudo chown <user>:<user> /var/www/sitename
sudo chmod 775 /var/www/sitename
cd /var/www/sitename
ghost install

Der Befehl stellt dann seine Fragen, und das Projekt empfiehlt, bei jedem vorgeschlagenen Schritt mit Ja zu antworten:

• Blog URL: die genaue Adresse der Website, mit https://.
• MySQL: localhost als Host, root und das oben gesetzte Passwort, dann der Name der Datenbank, die Ghost-CLI anlegt.
• Set up a ghost MySQL user: ein MySQL-Konto, das auf die Datenbank von Ghost beschränkt ist.
• Set up NGINX und Set up SSL: die Konfiguration von Nginx und das Zertifikat von Let’s Encrypt, das eine E-Mail-Adresse verlangt.
• Set up systemd und Start Ghost: der Dienst, der Ghost am Laufen hält, dann sein Start.

Die Website antwortet nun, und https://example.com/ghost fordert Sie auf, das Konto des Eigentümers anzulegen. Wird die Installation unterbrochen, setzt ghost setup die Konfiguration fort; scheitert sie, räumt ghost uninstall besser auf als das Löschen des Ordners. ghost doctor prüft das System jederzeit.

Ghost mit Docker Compose installieren (Preview)

Das Projekt stellt diese Methode als „Preview“ vor: Aus seiner Sicht ist sie ganz neu. Mit ihr lassen sich Web-Analytics und ActivityPub selbst hosten.

Holen Sie auf einem Server, auf dem Docker installiert ist, die offiziellen Werkzeuge nach /opt/ghost und kopieren Sie ihre beiden Beispieldateien:

git clone https://github.com/TryGhost/ghost-docker.git /opt/ghost && cd /opt/ghost
cp .env.example .env
cp caddy/Caddyfile.example caddy/Caddyfile

Tragen Sie in der Datei .env diese Werte ein:

• DOMAIN: die Domain der Website, zum Beispiel example.com.
• ADMIN_DOMAIN: eine getrennte Domain für die Administration, wenn Sie möchten.
• DATABASE_ROOT_PASSWORD und DATABASE_PASSWORD: zwei Passwörter, erzeugt mit openssl rand -hex 32. Sie werden ein für alle Mal festgelegt: Ist die Datenbank initialisiert, bricht die Verbindung ab, wenn man sie ändert.
• Der Abschnitt SMTP Email: Ihr Relay, weiter unten im Detail.

Entfernen Sie in caddy/Caddyfile die Kommentarzeichen des Blocks, der zu Ihrem Fall passt: Weiterleitung von www auf die Domain ohne Präfix oder umgekehrt oder getrennte Administrations-Domain. Starten Sie dann Ghost und schließen Sie die Einrichtung auf /ghost ab:

docker compose pull
docker compose up -d

• Die Ports: Nur Caddy veröffentlicht Ports, 80 und 443, änderbar mit HTTP_PORT und HTTPS_PORT, falls Ghost hinter einen anderen Reverse Proxy kommt. MySQL bleibt im internen Netz der Container.
• Die Daten: Die hochgeladenen Dateien liegen in data/ghost und die Datenbank in data/mysql, zwei Orte, die sich in der .env einstellen lassen.
• IPv6: Das Repository aktiviert es optional, weil es neuere Versionen von Docker und Compose verlangt. Ergänzen Sie dann -f compose.yml -f compose.ipv6.yml in Ihren Befehlen docker compose up.

Web-Analytics und ActivityPub

Die Analytics verlangen ein Tinybird-Konto, einen externen Dienst. Melden Sie sich aus /opt/ghost an, deployen Sie seine Konfiguration und holen Sie die Tokens, die in die .env gehören, Abschnitt „Tinybird configuration“:

docker compose run --rm tinybird-login
docker compose run --rm tinybird-sync
docker compose run --rm tinybird-deploy
docker compose run --rm tinybird-login get-tokens

ActivityPub funktioniert von Anfang an mit dem vom Projekt gehosteten Dienst, kostenlos innerhalb von Nutzungsgrenzen, die seine Dokumentation veröffentlicht. Um Ihren eigenen zu hosten, entfernen Sie das Kommentarzeichen bei ACTIVITYPUB_TARGET=activitypub:8080. Aktivieren Sie dann in der .env das oder die gewünschten Profile und starten Sie die Container neu:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

Für ActivityPub verlangt das Projekt, auch Ghost und Caddy neu zu erstellen, mit docker compose up -d --force-recreate ghost caddy.

Von Ghost-CLI auf Docker Compose wechseln

Nach dem Klonen und der Konfiguration kopiert bash scripts/migrate.sh den Ordner content, importiert die Datenbank in den MySQL-Container und startet Caddy anstelle von Nginx. Es bietet an, Nginx zu stoppen, was die Website offline nimmt: Antworten Sie mit Nein, wenn auf dem Server andere Websites laufen. Es löscht keine Daten. bash recovery_instructions.sh stellt die ursprüngliche Website wieder her, wenn Sie die Migration abbrechen.

HTTPS und Administrations-Domain

Die Administration von Ghost muss über HTTPS laufen, und das Projekt empfiehlt HTTPS für die ganze Website: Ohne es wandern Benutzernamen und Passwörter im Klartext. Mit Docker Compose übernimmt Caddy das. Mit Ghost-CLI richtet die Installation das Zertifikat ein, und ein Befehl holt es nachträglich nach:

ghost setup ssl

Um die Adresse einer mit Ghost-CLI installierten Website zu ändern, aktualisiert ghost config url https://example.com die Konfiguration, und ghost restart wendet sie an.

Das Projekt rät außerdem zu einer getrennten Administrations-Domain, die die Angriffsfläche verkleinert. Der Pfad bleibt /ghost/. Bei Ghost-CLI wird sie in der config.production.json deklariert:

"admin": {
  "url": "https://admin.example.com"
}

Tragen Sie bei Docker Compose ADMIN_DOMAIN ein, entfernen Sie die Kommentarzeichen seines Blocks im Caddyfile und führen Sie docker compose up -d --force-recreate ghost caddy aus. Auch diese Domain braucht ihre A- und AAAA-Einträge.

MySQL 8, die Produktionsdatenbank

MySQL 8 ist die einzige Datenbank, die das Projekt in der Produktion unterstützt. Ghost-CLI wird mit MySQL 8.0 oder 8.4 installiert, und die Compose-Datei liefert ein MySQL-8.0-Image.

• Von SQLite aus: Das Projekt empfiehlt eine vollständige Neuinstallation auf MySQL 8.
• Von MariaDB aus: Es empfiehlt dringend die Migration auf MySQL 8.
• Zum Prüfen: ghost config database.client zeigt im Ordner der Website, welche Datenbank genutzt wird.

Die E-Mails und die Newsletter

Ghost unterscheidet zwei Versandarten, die nicht denselben Weg nehmen. Das ist der wichtigste Punkt, den Sie nach der Installation einstellen müssen.

Das SMTP-Relay für die transaktionalen E-Mails

Die Dokumentation stuft diese Konfiguration in der Produktion als erforderlich ein. Ghost sendet außerdem einen Code per E-Mail, wenn es eine Anmeldung von einem neuen Gerät erkennt: Richten Sie dieses Relay ein, bevor Sie Ihr Team einladen.

Auf einem Simafri-VPS läuft der Versand über ein authentifiziertes SMTP-Relay auf Port 587: die Adresse eines Postfachs, das Sie bereits haben, oder Simafri Suite.

"mail": {
  "transport": "SMTP",
  "from": "'Acme Support' <support@example.com>",
  "options": {
    "host": "smtp.example.com",
    "port": 587,
    "secure": false,
    "requireTLS": true,
    "auth": {
      "user": "support@example.com",
      "pass": "1234567890"
    }
  }
}

mail__transport=SMTP
mail__options__host=smtp.example.com
mail__options__port=587
mail__options__secure=false
mail__options__requireTLS=true
mail__options__auth__user=support@example.com
mail__options__auth__pass=1234567890
mail__from="'Acme Support' <support@example.com>"

docker compose up -d --force-recreate ghost

• secure und requireTLS: Ghost sendet über Nodemailer, dessen Dokumentation auf Port 587 secure auf false verlangt, wobei die Verbindung danach auf STARTTLS wechselt. requireTLS verweigert den Versand, wenn dieser Wechsel scheitert. Die Beispieldatei des Repositorys gibt Port 465 und secure=true an: Ersetzen Sie diese beiden Zeilen.
• Die Absenderadresse: from trägt eine echte, gelesene Adresse, was laut Projekt die Zustellbarkeit verbessert, und die SPF-, DKIM- und DMARC-Einträge der Versanddomain runden die Einstellung ab.
• Der Test: Laden Sie ein Teammitglied über die Administration ein und prüfen Sie den Empfang.

Mailgun für die Newsletter

Das SMTP-Relay deckt die Newsletter nicht ab. Laut Dokumentation erfolgt der Massenversand nicht per SMTP, und Mailgun ist bislang der einzige Dienst für den Massenversand, den Ghost unterstützt. Sie legen Ihr Mailgun-Konto an und tragen dessen API-Schlüssel in den Einstellungen von Ghost ein.

Wenn Sie Ihre Artikel nicht per E-Mail versenden, brauchen Sie kein Mailgun-Konto: Diese Einstellungen können Sie ignorieren. Wenn Sie ein anderes Newsletter-Werkzeug bevorzugen, schlägt das Projekt vor, Ihre Mitglieder dorthin zu synchronisieren, zum Beispiel mit Zapier oder seinen Integrationsanleitungen.

Ghost sichern und wiederherstellen

Ghost bietet drei Stufen der Kopie, und sie enthalten nicht dasselbe. Um eine Website identisch wieder aufzubauen, verlangt das Projekt, die Datenbank und den Ordner content direkt zu sichern.

Der Export steht unter „Settings“, „Advanced“, „Import/Export“, Reiter „Export“, Schaltfläche „All data“. Für die vollständige Kopie mit Ghost-CLI stehen das MySQL-Konto und der Name der Datenbank, die Sie übernehmen müssen, in der config.production.json:

mkdir -p ~/ghost-backups
mysqldump -u ghost_user -p ghost_production > ~/ghost-backups/ghost_backup.sql
cd /var/www/sitename
tar czf ~/ghost-backups/ghost_content_backup.tar.gz content/

Mit Docker Compose bewahren die offiziellen Werkzeuge den Inhalt in data/ghost auf. Der Dump übernimmt die Form, die das MySQL-Image vorgibt, und das Root-Passwort steckt schon im Container. Bewahren Sie auch eine Kopie der .env und des Caddyfile auf.

cd /opt/ghost
mkdir -p ~/ghost-backups
docker compose exec -T db sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" ghost' > ~/ghost-backups/ghost_backup.sql
tar czf ~/ghost-backups/ghost_content_backup.tar.gz data/ghost

Wiederherstellen

cd /var/www/sitename
ghost stop
mysql -u ghost_user -p ghost_production < ~/ghost-backups/ghost_backup.sql
tar xzf ~/ghost-backups/ghost_content_backup.tar.gz
sudo chown -R ghost:ghost content
ghost restart

cd /opt/ghost
docker compose stop ghost
docker compose exec -T db sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" ghost' < ~/ghost-backups/ghost_backup.sql
tar xzf ~/ghost-backups/ghost_content_backup.tar.gz
docker compose start ghost

Kopieren Sie diese Dateien mit rsync oder scp vom Server weg und machen Sie einen Wiederherstellungstest auf einer Testmaschine. Wenn Sie von einem Export mit zahlenden Mitgliedern neu starten, verbinden Sie dasselbe Stripe-Konto, bevor Sie Ihre Mitglieder importieren.

Ghost aktualisieren

Das Projekt veröffentlicht jede Woche Updates und erinnert daran, dass ein öffentlicher Webserver aktuell bleiben muss. Lesen Sie die Release Notes und führen Sie dann den Befehl Ihrer Methode aus.

Mit Ghost-CLI

ghost check-update
ghost backup
ghost update

• Der Weg zurück: ghost update --rollback geht auf die vorherige Version zurück, wenn ein Update schiefgeht.
• Der Ordner content bleibt bei den Updates erhalten.
• Die Hauptversionen erscheinen alle 12 bis 18 Monate und brechen die Kompatibilität: Die Dokumentation verlangt Backups, das Lesen der Änderungen und die Prüfung der Theme-Kompatibilität.
• Node.js: Ändern Sie es getrennt von Ghost und führen Sie dann ghost update [version] --force mit Ihrer aktuellen Version aus, denn seine binären Abhängigkeiten sind für eine bestimmte Version von Node.js kompiliert.

Mit Docker Compose

cd /opt/ghost
git pull
docker compose pull
docker compose up -d
docker image prune

Die letzte Zeile, optional, entfernt die alten Images. Lassen Sie GHOST_VERSION in der .env auskommentiert: Eine festgelegte Version blockiert diese Update-Befehle.

Ihre Instanz härten und wachsen lassen

Die Dokumentation nennt mehrere Einstellungen für einen Server in der Produktion:

• MySQL: Führen Sie mysql_secure_installation nach einer erfolgreichen Ghost-CLI-Installation aus.
• Die Firewall: UFW-Regeln für SSH, Nginx, HTTP und HTTPS, ohne eine weitere Firewall daneben.
• SSH: Anmeldung nur per Schlüssel, ohne Passwort und ohne Konto root.
• Das Team: Die Zwei-Faktor-Authentifizierung wird unter „Settings“, „Staff“ für alle Anmeldungen verpflichtend gemacht.

Für die Last setzt das Projekt ein CDN und eine Cache-Schicht vor Ghost. Es stellt klar, dass Clustering und Sharding nicht unterstützt werden: Eine einzige Instanz bedient die Website, und der Cache fängt den Traffic ab.

Wer was tut auf einem Managed VPS

Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Ghost bleibt Ihre Software, mit ihren Einstellungen und Daten.

Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.