Cómo instalar PyroCMS en un servidor Ubuntu 24.04

PyroCMS es un CMS de código abierto basado en PHP y Laravel. Es un potente sistema de gestión de contenido con MySQL/MariaDB como base de datos y también proporciona una administración web intuitiva y simple para una gestión más fácil.

En este tutorial, te guiaremos a través de la instalación de PyroCMS en Ubuntu 24.04 con el LEMP Stack (Linux, Nginx, MySQL/MariaDB y PHP-FPM) y Composer.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

Un servidor Ubuntu 24.04.
Un usuario no root con privilegios de administrador.
Un nombre de dominio apuntando a la dirección IP del servidor.

Instalando dependencias

PyroCMS es un sistema de gestión de contenido basado en Laravel con MySQL/MariaDB como base de datos. Antes de instalar PyroCMS, instalarás el LEMP Stack (Linux, Nginx, MySQL/MariaDB y PHP-FPM) y Composer en tu sistema Ubuntu.

Primero, ejecuta el siguiente comando apt para actualizar tu índice de paquetes e instalar el LEMP Stack (Linux, Nginx, MySQL/MariaDB y PHP-FPM) y Composer.

sudo apt update sudo apt install nginx mariadb-server composer php-cli php-fpm php-mysql php-curl php-sqlite3 php-mbstring php-gd php-xml

Ingresa Y para confirmar la instalación.

install deps

Después de la instalación, verifica los servicios del LEMP Stack para asegurarte de que esos servicios estén en funcionamiento.

Verifica el servidor web Nginx con el siguiente comando systemctl.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Ahora verifica el estado del servidor MariaDB con lo siguiente:

check nginx

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadbn

A continuación, ejecuta el siguiente comando para verificar el servicio PHP-FPM.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

check php-fpm

Por último, verifica la versión de Composer usando el siguiente comando. Verás que Composer 2.4.7 está instalado.

sudo -u www-data composer --version

Configurando PHP-FPM

Después de haber instalado las dependencias, configurarás PHP-FPM cambiando algunas configuraciones predeterminadas a través del archivo php.ini y reiniciando el servicio PHP-FPM.

Abre el archivo php.ini para PHP-FPM con el editor nano.

sudo nano /etc/php/8.3/fpm/php.ini

Cambia la configuración predeterminada con lo siguiente y ajusta las opciones date.timezone y memory_limit según tu entorno actual.

date.timezone = Europe/Amsterdam  
max_execution_time = 130  
memory_limit = 256M  
allow_url_fopen = On  
allow_url_include = Off  
post_max_size = 128M  
upload_max_filesize = 128M  
max_input_vars = 5000

Cuando termines, guarda el archivo y sal del editor.

Ahora ejecuta el comando systemctl a continuación para reiniciar el servicio PHP-FPM y aplicar tus cambios en php.ini.

sudo systemctl restart php8.3-fpm

Configurando el servidor MariaDB

Ahora que has configurado PHP-FPM, asegurarás la instalación del servidor MariaDB y crearás una nueva base de datos y usuario para PyroCMS.

Asegura tu instalación del servidor MariaDB con el comando mariadb-secure-installation a continuación.

sudo mariadb-secure-installation

Se te preguntará sobre las siguientes configuraciones:

¿Cambiar a autenticación unix_socket? Ingresa n y presiona ENTER.
El usuario root predeterminado de MariaDB ya está protegido. Opcionalmente, también puedes habilitarlo escribiendo y para sí.
Cambia la contraseña de root. Ingresa y para confirmar y configura tu nueva contraseña de root de MariaDB.
¿Eliminar usuarios anónimos? Ingresa y para confirmar.
¿Deshabilitar el inicio de sesión remoto de root? Ingresa y para confirmar. Solo se permitirá la conexión local si estás usando MariaDB.
¿Eliminar la base de datos de prueba y acceder a ella? Ingresa y para confirmar y eliminar la base de datos predeterminada ‘test’.
Por último, ingresa y nuevamente para recargar todos los privilegios de tabla en tu servidor MariaDB y aplicar nuevos cambios.

Después de haber configurado MariaDB, crearás una nueva base de datos y usuario para PyroCMS.

Inicia sesión en el servidor MariaDB con el comando mariadb a continuación. Ingresa tu contraseña de root cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos pyrocmsdb, un nuevo usuario pyrocms@localhost, y la contraseña es passw0rd. Cambia los detalles del nombre de la base de datos, nombre de usuario y contraseña según sea necesario.

CREATE DATABASE pyrocmsdb;  
GRANT ALL PRIVILEGES ON pyrocmsdb.* TO pyrocms@localhost IDENTIFIED BY 'passw0rd';  
FLUSH PRIVILEGES;

create database and user

A continuación, ejecuta la consulta a continuación para verificar los privilegios para el usuario pyrocms@localhost. Verás que la base de datos pyrocmsdb es accesible con el usuario pyrocms@localhost.

SHOW GRANTS FOR pyrocms@localhost;

Por último, escribe quit para salir del servidor MariaDB.

show db privileges

Descargando el código fuente de PyroCMS

Crea nuevos directorios para Composer y PyroCMS, ve a /var/www/pyrocms, y luego cambia la propiedad de los nuevos directorios al usuario www-data. En este caso, el /var/www/pyrocms se utilizará como la raíz del documento para PyroCMS.

mkdir -p /var/www/{.config,.cache,pyrocms}; cd /var/www/pyrocms  
sudo chown -R www-data:www-data /var/www/{.config,.cache,pyrocms}

Ahora ejecuta el comando composer a continuación para descargar el código fuente de PyroCMS, e instalar y actualizar las dependencias de PHP.

sudo -u www-data composer create-project pyrocms/pyrocms .  
sudo -u www-data composer update

A continuación, puedes ver la instalación de PyroCMS a través del comando composer:

download and install pyrocms dependencies

Después de que la instalación esté completa, pasa a la siguiente sección.

Configurando el bloque del servidor Nginx

En esta sección, crearás una nueva configuración de bloque del servidor Nginx para la instalación de PyroCMS. Así que asegúrate de tener un nombre de dominio apuntando a la dirección IP de tu servidor Ubuntu. En este ejemplo, usarás un nombre de dominio howtoforge.local.

Crea un nuevo bloque del servidor Nginx /etc/nginx/sites-available/pyrocms.conf con el editor nano.

sudo nano /etc/nginx/sites-available/pyrocms.conf

Copia y pega la siguiente configuración y asegúrate de cambiar el server_name con tu nombre de dominio.

server {  
 listen 80;  
 server_name howtoforge.local;  
  
 index index.php index.html;  
 root /var/www/pyro/public;  
   
 location / {  
  try_files $uri $uri/ /index.php?$args;  
 }  
  
 location ~ \.php$ {  
  include fastcgi_params;  
  fastcgi_pass unix:/run/php/php-8.3-fpm.sock;  
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
  fastcgi_index index.php;  
 }  
}

Cuando termines, guarda y sal del archivo.

Ahora ejecuta el comando a continuación para crear un enlace simbólico del archivo pyrocms.conf al directorio /etc/nginx/sites-enabled y verifica la sintaxis de tu Nginx.

sudo ln -s /etc/nginx/sites-available/pyrocms.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Si tienes una sintaxis de Nginx correcta, verás una salida test is successful - syntax is ok.

setup nginx

Por último, ejecuta el siguiente comando systemctl para reiniciar el servidor web Nginx y aplicar tus cambios.

sudo systemctl restart nginx

Asegurando PyroCMS con HTTPS a través de Letsencrypt

Para asegurar PyroCMS, implementarás HTTPS a través de Letsencrypt. Para eso, debes instalar Certbot para generar certificados SSL/TLS e implementar automáticamente HTTPS en tu instalación de PyroCMS.

Instala los paquetes certbot y python3-certbot-nginx con el siguiente comando. Ingresa Y para confirmar la instalación.

sudo apt install certbot python3-certbot-nginx

Ahora ejecuta el comando certbot a continuación para generar certificados SSL y asegurar PyroCMS con HTTPS.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Después de que el proceso termine, obtendrás tus certificados en el directorio /etc/letsencrypt/live/domain.com, y tu PyroCMS ahora está asegurado con HTTPS.

Instalando PyroCMS usando el instalador web

Abre tu navegador web y visita tu nombre de dominio como https://howtoforge.local/. Ahora verás una sola página de instalación de PyroCMS:

Selecciona I Agree para aceptar la licencia para la instalación de PyroCMS.
Ingresa tu nombre de base de datos, usuario y contraseña.
Ingresa un nuevo usuario administrador, dirección de correo electrónico y contraseña para tu PyroCMS.
Ingresa los detalles del sitio para tu instalación, como el nombre de dominio, idioma y zona horaria.
Haz clic en Install para confirmar la instalación.

install pyrocms

Después de que la instalación esté completa, verás la siguiente página:

install complete

Haz clic en View Site para acceder a la página de inicio de PyroCMS. A continuación, puedes ver la página de índice predeterminada para PyroCMS.

homepage

Haz clic en Login para acceder a la pantalla de inicio de sesión de PyroCMS. Ingresa tu usuario administrador y contraseña, y luego haz clic en Login.

Si tienes éxito, verás el panel de administración de PyroCMS como el siguiente:

dashboard

Conclusión

¡Felicidades! Has completado la instalación de PyroCMS en el servidor Ubuntu 24.04. Tienes PyroCMS instalado con el LEMP Stack (Linux, Nginx, MySQL/MariaDB y PHP-FPM). También has descargado PyroCMS con Composer y asegurado PyroCMS con HTTPS a través de Certbot y Letsencrypt.