Esta guía detalla la instalación y el mantenimiento de Ghost en un hosting web de Infomaniak, para obtener una plataforma optimizada para blogs y publicaciones, una alternativa eficaz a Substack o Medium.

Requisitos previos

• Un sitio web basado en Node.js (se recomienda la versión 22).
• 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 realizar cualquier operación técnica.

Instalación de Ghost

Para ello:

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

2. Ejecute los siguientes comandos para iniciar el instalador:

   # Clone tools repo
   git clone {{URL_5}}
   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...
   • tardará unos minutos, ¡sea paciente!

Responda a las preguntas con cuidado, utilizando los datos que haya anotado.No cierre la terminal hasta que haya terminado.

Configuration du Manager (Node.js)

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

1. Haga clic aquí para acceder a la gestión de su sitio web en el Panel de control de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al sitio web correspondiente:
   
3. Haga clic en Gestionar la 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. Compruebe que el número de puerto es 3000.
7. Desactive la casilla de la opción build.
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 Iniciar (o Reiniciar 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 Panel de control de Infomaniak.

2. Acceda al directorio de su sitio Ghost

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

   Reemplace ghost-site-name por el nombre real de su carpeta (por ejemplo: blog, misitio, 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. Compruebe 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 a la v5? Si utiliza Ghost v4 y desea actualizar a la v6, Ghost requiere que pase por la v5 como paso intermedio. Esto es imprescindible para las actualizaciones de versión principal.
5. Espere a que finalice la actualización y, a continuación, reinicie la aplicación desde el panel de control del sitio para aplicar la actualización.

¡Listo! Acceda a su blog de Ghost

A continuación, diríjase a la URL de su sitio web para comenzar:

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. Después, podrá empezar a escribir artículos.

Configuración de usuarios / correo electrónico

Para crear el primer usuario, añada /ghost a la URL de su sitio web (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 enviará la confirmación del doble opt-in desde una dirección específica.

Por defecto, se trata de la dirección “noreply” de su dominio. Para actualizarla, vaya a “Configuración”, “Suscripción”, “Configuración del portal”, “Personalizar” y “Página de la cuenta”:

Solucionar una incompatibilidad técnica entre Ghost y MariaDB

Algunas consultas SQL provocan errores HTTP 400 en MariaDB, lo que da como resultado 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 aplicar este parche, introduzca el siguiente comando:

# Enter the current version folder and apply the MariaDB patch
cd current
curl -L {{URL_16}} | patch -p0