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-basierte Website (Version 22 wird 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 Maßnahmen ergreifen.

Installation von Ghost

Dazu:

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

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

   # Clone tools repo
   git clone {{URL_5}}
   cd hosting-tools/h3-ghost
   # Run installation script
   bash ./install.sh

3. Das Skript wird nun:
   • Ihnen einige Fragen stellen (URL der Website, Datenbankinformationen, SMTP usw.)…
   • Ghost automatisch herunterladen und konfigurieren…
   • einige Minuten benötigen – bitte haben Sie Geduld!

Beantworten Sie die Fragen sorgfältig und verwenden Sie dabei die von Ihnen notierten Angaben.Schließen Sie das Terminal nicht, bevor es fertig ist!

Configuration du Manager (Node.js)

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

1. Klicken Sie hier, um die Verwaltung Ihrer Website im Infomaniak Manager aufzurufen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen der betreffenden Website:
   
3. Klicken Sie auf Erweiterte Einstellungen verwalten:
   
4. Klicken Sie auf den Reiter Node.js, um auf die Einstellungen zuzugreifen.

5. Geben Sie im Feld Ausführungsbefehl Folgendes ein:

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

6. Vergewissern Sie sich, dass die Portnummer 3000 lautet.
7. Deaktivieren Sie das Kontrollkästchen für Build.
8. Klicken Sie auf die Schaltfläche Speichern am unteren Rand der Seite:
   
9. Auf der Hauptseite klicken Sie auf die Schaltfläche Start (oder Neu starten, falls die Ausführung bereits erfolgt).
10. Bestätigen Sie die Aktion gegebenenfalls:
    
11. Beobachten Sie die Protokolle, die die Erstellung der Datenbank und den Start der Anwendung anzeigen.

Ghost aktualisieren

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

1. Beenden 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 einige Minuten dauern):

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

4. Überprüfen Sie, ob Updates verfügbar sind:

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

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

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

   Für eine bestimmte Version, z. B. v5 (der Vorgang kann einige Minuten dauern):

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

   • Warum die Version v5 verwenden? Wenn Sie Ghost v4 verwenden und auf v6 aktualisieren möchten, erfordert Ghost die Verwendung von v5 als Zwischenschritt. Dies ist für größere Versionsupdates 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.

Besuchen Sie anschließend die 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 Benutzerkennung für den Blog) …
   2. Anschließend können Sie mit dem Schreiben von Artikeln beginnen!

Konfiguration der Benutzer / E-Mail

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

Sie können auch die „Support-Adresse für das Mitgliederportal“ konfigurieren: Wenn sich neue Mitglieder registrieren möchten, sendet das Portal die Bestätigung des Double-Opt-In-Verfahrens von einer bestimmten Adresse aus.

Standardmäßig ist dies die „noreply“-Adresse Ihrer Domain. Um diese zu aktualisieren, navigieren Sie zu „Einstellungen“, „Abonnement“, „Portaleinstellungen“, „Anpassen“ und „Kontoseite“:

Behebung einer technischen Inkompatibilität zwischen Ghost und MariaDB

Bestimmte SQL-Abfragen führen zu HTTP 400-Fehlern in MariaDB, was zu folgender Fehlermeldung 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, steht ein Patch zur Verfügung, 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 {{URL_16}} | patch -p0