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.
• Arrestare l'applicazione Node.js nel Manager Infomaniak prima di qualsiasi operazione tecnica.

Installazione di Ghost

Per fare ciò:

1. Connettersi al server in SSH (bisogno di aiuto?).

2. Eseguire 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:
   • vi farà alcune domande (URL del sito, informazioni del database, SMTP, ecc.)…
   • scaricherà e configurerà automaticamente Ghost…
   • ci vorranno alcuni minuti — siate pazienti!

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

Configurazione del Manager (Node.js)

Una volta terminato lo script, andare nel Pannello di controllo Infomaniak:

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

5. Nel campo comando di esecuzione, inserisci:

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

6. Verifica che il numero di porta sia 3000.
7. Casella di comando di build : disattivala.
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. 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:

   # 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 un aggiornamento standard (ultima versione):

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

   Per una versione specifica (es: v5):

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

   • Perché passare alla v5? Se utilizzi Ghost v4 e desideri passare alla v6, Ghost richiede di passare alla v5 come passaggio intermedio. È indispensabile per gli aggiornamenti di versione principale.
5. Riavvia il tuo hosting nel Manager Infomaniak per applicare l'aggiornamento.

Fatto! Accedi al tuo blog Ghost

Successivamente, vai all'URL del tuo 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 (il vostro identificativo 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 nuovi membri desiderano 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 causano 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