Esta guía detalla la instalación y el mantenimiento de Ghost en un alojamiento web de Infomaniak, para obtener una plataforma optimizada para el blogging y la publicación editorial, una alternativa eficiente a Substack o Medium.

Requisitos previos

• Un sitio de tipo Node.js (se recomienda v22).
• Un acceso SSH activo.
• Una base de datos MySQL/MariaDB.
• Detenga la aplicación Node.js en el Manager de Infomaniak antes de cualquier operación técnica.

Instalación de Ghost

Para ello:

1. Conéctese a su servidor por SSH (¿necesita ayuda?).

2. Ejecute los siguientes comandos para iniciar el instalador:

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

3. El script ahora:
   • le hará algunas preguntas (URL del sitio, información de la base de datos, SMTP, etc.)…
   • descargará y configurará Ghost automáticamente…
   • tomará unos minutos — ¡sea paciente!

Responda a las preguntas cuidadosamente utilizando los detalles que ha anotado. ¡No cierre el terminal hasta que haya terminado!

Configuración del Manager (Node.js)

Una vez que el script haya terminado, vaya a su Panel de control de Infomaniak:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto correspondiente.
3. Haga clic en Gestionar bajo Configuración avanzada:
   
4. Haga clic en la pestaña Node.js para acceder a la configuración.

5. En el campo de comando de ejecución, introduzca:

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

6. Verifique que el número de puerto sea 3000.
7. Caja de comando de build : desactívela.
8. Haga clic en el botón Guardar al final de la página:
   
9. En la página principal, haga clic en el botón Start (o Restart si ya está en ejecución).
10. Observe los registros que muestran la creación de la base de datos y el inicio de la aplicación:
    
    

Actualización de Ghost

Para actualizar Ghost CMS a la última versión o a una versión específica, siga estos pasos:

1. Detenga la aplicación Node.js en el Manager Infomaniak.

2. Acceda al directorio de su sitio Ghost

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

   Remplace <ghost-site-name> por el nombre real de su carpeta (por ejemplo, blog, mysite, etc.).

3. Asegúrese de que los permisos de los archivos sean correctos:

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

4. Verifique las actualizaciones disponibles:

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

   Para una actualización estándar (última versión):

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

   Para una versión específica (por ejemplo, v5):

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

   • ¿Por qué pasar por la v5? Si usa Ghost v4 y desea pasar a la v6, Ghost requiere pasar por la v5 como paso intermedio. Es indispensable para las actualizaciones de versión mayor.
5. Reinicie su alojamiento en el Manager Infomaniak para aplicar la actualización.

¡Listo! Acceda a su blog Ghost

Vaya luego a la URL de su sitio para iniciar:

1. Abra su navegador y vaya a https://domain.xyz/ghost (reemplace domain.xyz con su dominio actual).
2. La primera vez:
   1. Creará una cuenta de administrador (su identificador para el blog)...
   2. ¡Luego, podrá comenzar a escribir artículos!

Configuración de usuarios / correo electrónico

Para crear el primer usuario, agregue /ghost a la URL de su sitio (por ejemplo, https://ghost.domain.xyz/ghost) y siga el asistente.

También puede configurar la "dirección de soporte del portal de miembros": cuando los nuevos miembros deseen registrarse, el portal envía la confirmación de doble opt-in desde una dirección específica.

Por defecto, es la dirección "noreply" de su dominio. Para actualizarla, navegue a "Configuración", "Membresía", "Configuración del portal", "Personalizar" y "Página de cuenta":

Resolver una incompatibilidad técnica entre Ghost y MariaDB

Algunas consultas SQL provocan errores HTTP 400 en MariaDB, lo que resulta en este tipo de error:

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

Si es necesario, existe un parche para adaptar el comportamiento de Ghost.

Para usar este parche, ingrese este 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