Mettre à Jour Ghost en 2026 : Méthode Sûre (CLI & Ghost Pro) + Backups

Mettre à jour Ghost est une étape essentielle pour maintenir la sécurité, les performances et les nouvelles fonctionnalités de votre site. Que vous gériez un blog personnel, un site pour une petite entreprise ou une startup, une mise à jour mal gérée peut causer des interruptions. Dans cet article, nous couvrons les méthodes pour Ghost auto-hébergé (via CLI) et Ghost(Pro), en nous basant sur les instructions officielles. Nous aborderons aussi les backups pour éviter toute perte de données, et comment comprendre les changements majeurs.

L'objectif est simple : vous guider pas à pas pour une mise à jour sans risque. Toutes les informations proviennent des docs officielles de Ghost, mises à jour pour 2025. La version stable actuelle est la 6.x, avec un support pour Node.js v22 et MySQL 8 uniquement.

Pourquoi Mettre à Jour Ghost Régulièrement ?

Ghost publie des mises à jour hebdomadaires pour corriger les vulnérabilités, améliorer la vitesse et ajouter des fonctionnalités comme de meilleures APIs ou des outils pour les newsletters. Ignorer ces mises à jour expose votre site à des risques de sécurité. Par exemple, les versions antérieures à 6.0 manquent de protections contre les attaques récentes sur les APIs.

Pour les SMB et startups, une mise à jour fluide signifie moins de downtime : un site lent ou vulnérable peut faire fuir les visiteurs ou les abonnés payants. Vérifiez toujours les changements officiels avant de commencer, pour anticiper les impacts sur vos thèmes ou intégrations.

Mise à Jour pour Sites Auto-Hébergés avec Ghost CLI

Si vous hébergez Ghost sur un VPS comme DigitalOcean, utilisez Ghost CLI. C'est gratuit et flexible, idéal pour les startups qui veulent contrôler leur infrastructure.

Prérequis

  • Version actuelle : Si vous êtes sur Ghost 6.x, c'est simple. Pour les versions < 3.0 ou avec SQLite en production, une réinstallation complète est recommandée.
  • Environnement : Node.js v22 (les versions 18 et 20 ne sont plus supportées). MySQL 8 obligatoire pour production ; SQLite seulement pour dev.
  • Backup préalable : Exécutez ghost backup pour sauvegarder la base de données, les thèmes et les fichiers. Cela crée un fichier .zip dans /content que vous pouvez restaurer si besoin.
  • Thèmes et plugins : Testez-les en local. Ghost 6.0 supprime le support pour certains fichiers sans extension dans les thèmes, et les assets manquants renvoient maintenant un 404 correct.

Étapes Pas à Pas

  1. Vérifiez après mise à jour :
    • Accédez à votre admin Ghost et vérifiez que tout fonctionne (posts, membres, newsletters).
    • Testez les APIs si vous en utilisez : Ghost 6.0 limite les résultats à 100 par requête (plus de ?limit=all).
    • Pour les thèmes : Assurez-vous que les images et liens sont relatifs/absolus correctement.

Lancez la mise à jour :

ghost update

CLI télécharge et installe la dernière version stable. Le processus prend 2-5 minutes, selon votre connexion. Il redémarre automatiquement le service.

Vérifiez les mises à jour disponibles :
Connectez-vous à votre serveur via SSH et naviguez vers le dossier de votre instance Ghost (généralement cd ~/your-ghost-site). Exécutez :

ghost check-update

Cela affiche si une mise à jour est disponible. Si vous êtes déjà sur la dernière 6.x, rien ne se passe.

Gestion des Thèmes et Intégrations

Les mises à jour peuvent casser les thèmes custom. Dans Ghost 6.0, les helpers comme {{date}} sont localisés par défaut. Si vous avez des intégrations (ex. : Zapier via webhooks), testez-les : l'endpoint /ghost/api/admin/session/ est supprimé, remplacez par /ghost/api/admin/users/me/.

Pour les plugins, Ghost CLI ne gère pas les "web analytics" tiers directement – injectez-les via code injection dans l'admin.

Comprendre les Breaking Changes

Les mises à jour majeures comme de 5.x à 6.x introduisent des changements qui peuvent affecter votre site. Consultez toujours le journal des changements pour votre version cible.

Changements Clés en Ghost 6.0

  • API : Limite de 100 résultats max par endpoint. Utilisez la pagination pour les gros sites. L'Admin API supprime /session/ au profit de /users/me/.
  • Base de données : Seulement MySQL 8. Les champs created_by/updated_by sont supprimés – utilisez la table actions pour les audits.
  • Thèmes : Fichiers sans extension non servis. AMP est complètement retiré (Google ne le priorise plus).
  • Performances : Nettoyage des anciens users (ID incrémentaux), ce qui peut prendre du temps sur les gros sites.

De 5.0 à 6.0

  • Éditeur : Passage de Mobiledoc à Lexical pour le stockage des posts. Si vous avez des intégrations custom, migrez-les.
  • Membres : Les endpoints /products/ deviennent /tiers/. Les prix sont maintenant numériques avec une devise séparée.
  • API globale : Plus de versions multiples ; utilisez l'en-tête accept-version pour la compatibilité.

Pour les startups avec des abonnements, vérifiez les flux de paiement : les bénéfices des tiers sont maintenant des listes de strings.

Si un breaking change impacte votre site, roulez back en restaurant le backup CLI : ghost rollback (disponible si vous avez backup récent).

Mise à Jour pour Ghost(Pro)

Ghost(Pro) est géré, parfait pour les SMB qui veulent zéro maintenance serveur. Les mises à jour sont automatiques, mais vous pouvez forcer si besoin.

Comment Ça Marche

  • Automatique : Ghost met à jour votre site vers la dernière version stable sans intervention. Vous recevez un email de notification.
  • Forcer une mise à jour : Dans l'admin > Settings > General, vérifiez la version. Si une mise à jour est en attente, contactez le support via le dashboard pour la déclencher manuellement (rarement nécessaire).
  • Préparation : Les backups sont inclus (voir ci-dessous). Testez en staging si vous avez un plan avancé.

Pour les changements, ils s'appliquent comme pour l'auto-hébergé : API limitée à 100, MySQL 8 only. Ghost(Pro) gère la compatibilité Node.js.

Avantage pour startups : Pas de downtime planifié, et le support aide pour les breaking changes.

Backups : La Clé pour Éviter les Pertes de Données

Un backup avant toute mise à jour est non négociable. Il couvre la DB, les posts, les membres et les thèmes.

Backups Automatiques dans Ghost(Pro)

  • Fonctionnement : Quotidiens et gérés par Ghost. Ils incluent tout : contenu, abonnés, analytics.
  • Rétention : 30 jours par défaut. Vous pouvez télécharger des exports on-demand depuis l'admin (contenu, membres, thèmes).
  • Restauration : Contactez [email protected] pour un archive complet (images incluses). Utile pour migrations ou fermetures. Pas pour routine – utilisez les APIs pour scripts custom.
  • Pour SMB : Activez les exports automatiques via Admin API si vous intégrez avec Google Drive.

Backups Manuels pour Auto-Hébergé

  • Via CLI : ghost backup crée un .zip complet. Stockez-le off-site (AWS S3, Dropbox).
  • Fréquence : Hebdomadaire + avant mises à jour. Pour startups en croissance, quotidien via cron job : 0 2 * * * cd /path/to/ghost && ghost backup.
  • Outils recommandés : mysqldump pour DB manuelle, rsync pour fichiers. Restaurez avec ghost restore backup-YYYY-MM-DD-HH-MM-SS.zip.
  • Meilleures pratiques : Testez la restauration mensuellement. Pour les abonnés payants, backuppez les données Stripe séparément.

Dans les deux cas, les exports ne incluent pas les clés Stripe pour sécurité – régénérez-les si restauration.

Pause de Subscription Ghost(Pro) : Quand et Comment

Si votre startup traverse une phase calme, pauser Ghost(Pro) évite les coûts sans perdre de données.

  • Éligibilité : Plans Starter et supérieurs. Durée : 1 à 3 mois.
  • Processus : Dans le dashboard > Billing > Pause. Confirmez – le site passe en mode lecture seule.
  • Ce qui se Passe : Site accessible mais non éditable. Données préservées, backups continuent. Newsletters et paiements en pause.
  • Réactivation : À la fin, ou manuellement. Coût : Aucun pendant la pause, mais facturation reprend à 100%.
  • Implications pour Maintenance : Mises à jour automatiques pausées. Idéal pour tester des backups manuels.

Pour auto-hébergé, pas de pause – arrêtez juste le serveur.

Bonnes Pratiques pour Maintenance Globale

  • Routine : Vérifiez les mises à jour mensuellement. Surveillez les logs via ghost log.
  • Sécurité : Après update, changez les mots de passe si breaking changes sur auth.
  • Pour Débutants : Commencez en local (ghost install local) pour tester.
  • SMB/Startups : Intégrez des outils comme UptimeRobot pour alerter sur downtime. Budget : 30 min/mois pour checks.

En suivant ces étapes, votre site reste stable. Si un problème surgit, le forum Ghost ou le support Pro est là. Prochaine étape : explorez les APIs pour automatiser plus.