Dieser Leitfaden beschreibt die Installation und Wartung von Ghost auf einem Webhosting von Infomaniak, um eine optimierte Plattform für Blogging und redaktionelle Veröffentlichungen zu erhalten, eine leistungsstarke Alternative zu Substack oder Medium.

Voraussetzungen

• Eine Node.js-Website (Version 22 empfohlen).
• Ein aktiver SSH-Zugang.
• Eine MySQL/MariaDB-Datenbank.
• Beenden Sie die Node.js-Anwendung über das Dashboard Ihrer Node.js-Website, bevor Sie technische Arbeiten durchführen.

Installation von Ghost

Dazu:

1. Melden Sie sich bei Ihrem Server über SSH an (Hilfe benötigt?).

2. Führen Sie die folgenden Befehle aus, um den Installationsassistenten zu starten:

   # Clone tools repo
   git clone https://github.com/Infomaniak/hosting-tools.git
   cd hosting-tools/h3-ghost
   # Run installation script
   bash ./install.sh

3. Das Skript führt nun folgende Schritte aus:
   • stellt Ihnen einige Fragen (URL der Website, Datenbankinformationen, SMTP usw.)…
   • lädt Ghost herunter und konfiguriert es automatisch…
   • dauert einige Minuten — haben Sie Geduld!

Beantworten Sie die Fragen sorgfältig unter Verwendung der Details, die Sie notiert haben. Schließen Sie das Terminal nicht, bevor es abgeschlossen ist!

Konfiguration des Managers (Node.js)

Sobald das Skript abgeschlossen ist, gehen Sie zu Ihrem Infomaniak-Kontrollpanel:

1. Hier klicken, um auf die Verwaltung Ihrer Website im Infomaniak-Manager zuzugreifen (Hilfe benötigt?).
2. Klicken Sie direkt auf den Namen der betreffenden Website:
   
3. Klicken Sie auf Verwalten unter Erweiterte Einstellungen:
   
4. Klicken Sie auf die Registerkarte Node.js, um auf die Einstellungen zuzugreifen.

5. Geben Sie im Feld Ausführungsbefehl ein:

   /srv/customer/node_modules/ghost-cli/bin/ghost run

6. Stellen Sie sicher, dass die Portnummer 3000 ist.
7. Befehlsfeld build : deaktivieren Sie es.
8. Klicken Sie auf die Schaltfläche Speichern unten auf der Seite:
   
9. Auf der Hauptseite klicken Sie auf die Schaltfläche Start (oder Neustart, wenn bereits ausgeführt).
10. Bestätigen Sie den Vorgang, falls erforderlich:
    
11. Beobachten Sie die Protokolle, die die Erstellung der Datenbank und den Start der Anwendung zeigen.

Aktualisierung von Ghost

Um Ghost CMS auf die neueste Version oder eine spezifische Version zu aktualisieren, folgen Sie diesen Schritten:

1. Stoppen Sie die Node.js-Anwendung im Infomaniak-Manager.

2. Greifen Sie auf das Verzeichnis Ihrer Ghost-Website zu

   # Navigate to your Ghost site directory
   cd ~/sites/ghost-site-name

   Ersetzen Sie ghost-site-name durch den tatsächlichen Namen Ihres Ordners (z. B. blog, mysite usw.).

3. Stellen Sie sicher, dass die Dateiberechtigungen korrekt sind (der Vorgang kann mehrere Minuten dauern):

   # Ensure file permissions are correct
   find ./ -type d -exec chmod -v 00775 {} \;

4. Überprüfen Sie die verfügbaren Updates:

   # Check available ghost updates
   /srv/customer/node_modules/ghost-cli/bin/ghost check-update

   Für die neueste Version (der Vorgang kann mehrere Minuten dauern):

   # Update to the latest version
   /srv/customer/node_modules/ghost-cli/bin/ghost update

   Für eine spezifische Version wie die v5 (der Vorgang kann mehrere Minuten dauern):

   # Update to a specific version (e.g., v5)
   /srv/customer/node_modules/ghost-cli/bin/ghost update v5

   • Warum über die v5 gehen? Wenn Sie Ghost v4 verwenden und zu v6 wechseln möchten, erfordert Ghost den Übergang über v5 als Zwischenstufe. Dies ist unerlässlich für große Versionsupgrades.
5. Warten Sie, bis die Aktualisierung abgeschlossen ist, und starten Sie dann die Anwendung über das Site-Dashboard neu, um die Aktualisierung anzuwenden.

Fertig! Greifen Sie auf Ihren Ghost-Blog zu

Gehen Sie dann zur URL Ihrer Website, um zu beginnen:

1. Öffnen Sie Ihren Browser und gehen Sie zu https://domain.xyz/ghost (ersetzen Sie domain.xyz durch Ihre aktuelle Domain).
2. Das erste Mal:
   1. Sie erstellen ein Administratorkonto (Ihre Anmeldedaten für den Blog)...
   2. Anschließend können Sie mit dem Schreiben von Artikeln beginnen!

Benutzer-/E-Mail-Konfiguration

Um den ersten Benutzer zu erstellen, fügen Sie /ghost zur URL Ihrer Website hinzu (z.B. https://ghost.domain.xyz/ghost) und folgen Sie dem Assistenten.

Sie können auch die "Support-Adresse des Mitgliederportals" konfigurieren: Wenn neue Mitglieder sich anmelden möchten, sendet das Portal die Bestätigung des Double-Opt-In von einer bestimmten Adresse aus.

Standardmäßig handelt es sich dabei um die Adresse „noreply“ Ihrer Domain. Um sie zu aktualisieren, navigieren Sie zu „Einstellungen“, „Mitgliedschaft“, „Portal-Einstellungen“, „Anpassen“ und „Konto-Seite“:

Ein technisches Problem zwischen Ghost und MariaDB beheben

Bestimmte SQL-Abfragen verursachen HTTP 400-Fehler auf MariaDB, was zu diesem Fehler führt:

[2025-01-01 12:54:28] ERROR "GET /ghost/api/admin/posts/6834625e35802b06f1496305/?formats=mobiledoc%2Clexical&include=tags%2Cauthors%2Cauthors.roles%2Cemail%2Ctiers%2Cnewsletter%2Ccount.conversions%2Ccount.clicks%2Csentiment%2Ccount.positive_feedback%2Ccount.negative_feedback" 400 27ms
Could not understand request.
Error ID:
8f2b0d90-3a30-11f0-a25f-fd9c83e1cf02
Error Code:
ER_BAD_FIELD_ERROR
----------------------------------------
Error: select `posts`.*,
...

Falls erforderlich, gibt es einen Patch, um das Verhalten von Ghost anzupassen.

Um diesen Patch zu verwenden, geben Sie diesen Befehl ein:

# Enter the current version folder and apply the MariaDB patch
cd current
curl -L https://gist.githubusercontent.com/reneluria/8cbbfbc001e542c77d6d5887fbafe5d3/raw/65e0ce31753b4687d0eb67fc030734a35d3ffbad/ghost-post.patch | patch -p0