Questa guida dettaglia l'installazione e la manutenzione di Ghost su un hosting web Infomaniak, per ottenere una piattaforma ottimizzata per il blogging e la pubblicazione editoriale, un'alternativa performante a Substack o Medium.

Prerequisiti

• Un sito di tipo Node.js (v22 consigliato).
• Un accesso SSH attivo.
• Un database MySQL/MariaDB.
• Arresta l'applicazione Node.js dal dashboard del tuo sito Node.js prima di qualsiasi operazione tecnica.

Installazione di Ghost

Per fare questo:

1. Connettiti al tuo server in SSH (hai bisogno di aiuto?).

2. Esegui i seguenti comandi per avviare l'installatore:

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

3. Lo script ora:
   • ti farà alcune domande (URL del sito, informazioni del database, SMTP, ecc.)…
   • scaricherà e configurerà automaticamente Ghost…
   • impiegherà alcuni minuti — sii paziente!

Rispondi alle domande con attenzione utilizzando i dettagli che hai annotato. Non chiudere il terminale finché non ha finito!

Configurazione del Manager (Node.js)

Una volta che lo script è terminato, vai nel tuo Pannello di controllo Infomaniak:

1. Clicca qui per accedere alla gestione del tuo sito sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al sito interessato:
   
3. Clicca su Gestisci sotto Impostazioni avanzate:
   
4. Fai clic sulla scheda Node.js per accedere alle impostazioni.

5. Nel campo di esecuzione del comando, inserisci:

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

6. Verifica che il numero di porta sia 3000.
7. Caso di comando di build : disattivalo.
8. Fai clic sul pulsante Salva in fondo alla pagina:
   
9. Nella pagina principale, fai clic sul pulsante Start (o Restart se già in esecuzione).
10. Conferma l'operazione se necessario:
    
11. Osserva i log che mostrano la creazione del database e l'avvio dell'applicazione.

Aggiornamento di Ghost

Per aggiornare Ghost CMS all'ultima versione o a una versione specifica, segui questi passaggi:

1. Arresta l'applicazione Node.js nel Manager Infomaniak.

2. Accedi alla directory del tuo sito Ghost

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

   Sostituisci ghost-site-name con il nome reale della tua cartella (es: blog, mysite, ecc.).

3. Assicurati che i permessi dei file siano corretti (l'operazione può richiedere diversi minuti):

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

4. Verifica gli aggiornamenti disponibili:

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

   Per l'ultima versione (l'operazione può richiedere diversi minuti):

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

   Per una versione specifica come la v5 (l'operazione può richiedere diversi minuti):

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

   • Perché passare per la v5? Se utilizzi Ghost v4 e desideri passare alla v6, Ghost richiede di passare per la v5 come passaggio intermedio. È indispensabile per gli aggiornamenti di versione maggiore.
5. Attendi fino al termine dell'aggiornamento, quindi riavvia l'applicazione dal dashboard del sito per applicare l'aggiornamento.

Fatto! Accedi al tuo blog Ghost

Recatevi quindi all'URL del vostro sito per iniziare:

1. Aprite il vostro browser e andate su https://domain.xyz/ghost (sostituite domain.xyz con il vostro dominio attuale).
2. La prima volta:
   1. Creerete un account amministratore (la vostra identità per il blog)...
   2. Successivamente, potrete iniziare a scrivere articoli!

Configurazione degli utenti/mail

Per creare il primo utente, aggiungete /ghost all'URL del vostro sito (ad esempio https://ghost.domain.xyz/ghost) e seguite la procedura guidata.

Potete anche configurare l'indirizzo di supporto del portale dei membri: quando i nuovi membri vogliono iscriversi, il portale invia la conferma del doppio opt-in da un indirizzo specifico.

Per impostazione predefinita, si tratta dell'indirizzo “noreply” del vostro dominio. Per aggiornarlo, navigate su “Impostazioni”, “Iscritti”, “Impostazioni del portale”, “Personalizza”, e “Pagina dell'account”:

Risolvere un'incompatibilità tecnica tra Ghost e MariaDB

Alcune richieste SQL provocano errori HTTP 400 su MariaDB, con il risultato di questo tipo di errore:

[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`.*,
...

Se necessario, esiste una correzione per adattare il comportamento di Ghost.

Per utilizzare questa patch, inserite questo comando:

# 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