Dieser Leitfaden beschreibt die Installation und Wartung von Ghost auf einem Infomaniak Webhosting, 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 (v22 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

Dafür:

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

2. Führen Sie die folgenden Befehle aus, um den Installer 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 wird nun:
   • einige Fragen stellen (URL der Website, Datenbankinformationen, SMTP usw.)…
   • Ghost automatisch herunterladen und konfigurieren…
   • einige Minuten in Anspruch nehmen — 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 Erweiterte Einstellungen verwalten:
   
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 lautet.
7. Befehlskasten build : deaktivieren Sie ihn.
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 bestimmte 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 bestimmte 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 für große Versionsupgrades unerlässlich.
5. Warten Sie, bis die Aktualisierung abgeschlossen ist, und starten Sie die Anwendung dann über das Dashboard der Website 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. Danach können Sie mit dem Schreiben von Artikeln beginnen!

Benutzerkonfiguration / E-Mail

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“:

Behebung einer technischen Unverträglichkeit zwischen Ghost und MariaDB

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 ein 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