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 desde el panel de control de su sitio Node.js 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 sitio en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al sitio 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 en la parte inferior 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. Confirme la operación si es necesario:
    
11. 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 (la operación puede tardar varios minutos):

   # 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 la última versión (la operación puede tardar varios minutos):

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

   Para una versión específica como la v5 (la operación puede tardar varios minutos):

   # 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. Espere a que la actualización se complete y, luego, reinicie la aplicación desde el panel de control del sitio para aplicar la actualización.

¡Terminado! Acceda a su blog Ghost

Vaya a continuación a la URL de su sitio para comenzar:

1. Abra su navegador y vaya a https://domain.xyz/ghost (reemplace domain.xyz por 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, vaya 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