Tutorial Install Joomla en Nginx con PHP-FPM y MariaDB

Paso 1: Actualizar el Sistema Ubuntu

Antes de instalar cualquier paquete, es una regla de oro en la administración de servidores actualizar los repositorios locales y aplicar los parches de seguridad existentes. Esto previene conflictos de dependencias, especialmente cuando preparamos el terreno para Joomla con PHP 8.3.

Conéctate a tu servidor por SSH y ejecuta:

sudo apt update && sudo apt upgrade -y

El parámetro -y asume un "sí" a todas las confirmaciones, agilizando el proceso. Si el sistema te pregunta qué hacer con archivos de configuración modificados, la práctica recomendada es mantener tu versión actual pulsando "Enter".

Paso 2: Instalar Nginx

Procedemos a instalar el corazón de nuestro servidor web. Nginx se encargará de recibir las peticiones HTTP/HTTPS, despachar los archivos estáticos (imágenes, CSS) de forma autónoma y delegar la ejecución de los scripts de Joomla a PHP-FPM.

sudo apt install nginx -y

Una vez completada la instalación, debemos asegurarnos de que el servicio esté corriendo y habilitado para arrancar automáticamente si el servidor se reinicia:

sudo systemctl start nginx
sudo systemctl enable nginx
sudo systemctl status nginx

Paso 3: Instalar PHP-FPM y extensiones necesarias

Nginx, a diferencia de Apache con su módulo mod_php, no procesa código PHP de manera nativa. Requiere un gestor externo. Utilizaremos PHP-FPM para Joomla, el cual se comunica con Nginx a través de un socket FastCGI. Para obtener el máximo rendimiento, instalaremos Joomla con PHP 8.3.

1. Añadir el repositorio de Ondřej Surý (Si usas Ubuntu 22.04)

Si estás en Ubuntu 24.04, PHP 8.3 suele estar en los repositorios oficiales. Si estás en una versión anterior, añade este PPA confiable:

sudo add-apt-repository ppa:ondrej/php
sudo apt update

2. Instalar PHP 8.3 y Módulos requeridos por Joomla

Joomla es un ecosistema complejo que requiere módulos específicos para el manejo de XML, encriptación, manipulación de imágenes y conexión a la base de datos. Ejecutamos la instalación integral:

sudo apt install php8.3-fpm php8.3-mysql php8.3-xml php8.3-zip php8.3-curl php8.3-gd php8.3-intl php8.3-mbstring php8.3-bcmath php8.3-opcache -y

3. Verificar y configurar PHP-FPM

Confirmemos que PHP-FPM se instaló correctamente y está en ejecución:

sudo systemctl status php8.3-fpm

Ajustes críticos en php.ini para Joomla: Joomla requiere ajustar los límites de carga y memoria por defecto de PHP. Editaremos el archivo principal de FPM:

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

Busca (usando Ctrl + W) y modifica las siguientes líneas para que queden así:

• memory_limit = 256M
• upload_max_filesize = 64M
• post_max_size = 64M
• max_execution_time = 120
• date.timezone = Europe/Madrid (o tu zona horaria local)

Guarda los cambios y reinicia el servicio PHP-FPM para aplicar la nueva configuración:

sudo systemctl restart php8.3-fpm

Paso 4: Instalar MariaDB

El siguiente componente del stack es la base de datos relacional. Como explicamos, utilizaremos MariaDB para Joomla debido a su excepcional rendimiento en servidores Linux modernos.

sudo apt install mariadb-server mariadb-client -y

Tras la instalación, debemos asegurar el motor de bases de datos. MariaDB incluye un script nativo que elimina bases de datos de prueba, deshabilita el login remoto del usuario root y establece políticas de contraseñas. Ejecútalo:

sudo mysql_secure_installation

Te hará una serie de preguntas. Presiona Enter en la primera (la contraseña actual está vacía). Luego responde "Y" (Yes) a todas las preguntas de seguridad, incluyendo cambiar a autenticación unix_socket y eliminar usuarios anónimos.

Paso 5: Crear la base de datos para Joomla

Es el momento de cómo configurar MariaDB para Joomla. Necesitamos crear una base de datos específica, un usuario dedicado y asignarle los privilegios correspondientes. Nunca utilices el usuario 'root' para tu instalación de Joomla por motivos de seguridad.

Accede a la consola de MariaDB:

sudo mysql -u root

Una vez dentro del prompt MariaDB [(none)]>, ejecuta las siguientes sentencias SQL (sustituye 'tu_contraseña_segura' por una clave fuerte real):

CREATE DATABASE joomla_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'joomla_user'@'localhost' IDENTIFIED BY 'tu_contraseña_segura';
GRANT ALL PRIVILEGES ON joomla_db.* TO 'joomla_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Paso 6: Descargar Joomla

Con el entorno LEMP preparado, vamos a obtener los archivos centrales del CMS directamente desde la fuente oficial.

1. Navegar al directorio temporal y descargar

cd /tmp
wget https://downloads.joomla.org/cms/joomla5/5-0-3/Joomla_5-0-3-Stable-Full_Package.zip

*Nota: Verifica en joomla.org el enlace de la última versión estable (5.x) y reemplaza la URL anterior si es necesario.

2. Descomprimir y copiar al directorio web

Primero, instalamos la utilidad unzip, creamos el directorio en la ruta donde Nginx sirve los archivos (/var/www/html/) y procedemos a la extracción:

sudo apt install unzip -y
sudo mkdir -p /var/www/html/joomla
sudo unzip Joomla_5-0-3-Stable-Full_Package.zip -d /var/www/html/joomla/

Paso 8: Configurar Virtual Host en Nginx

A diferencia de Apache, donde la reescritura de URLs (URLs amigables/SEF) funciona mágicamente arrastrando un archivo .htaccess, en Nginx el archivo .htaccess es completamente ignorado. Debemos configurar explícitamente el bloque del servidor (Virtual Host) e incluir las directivas de enrutamiento que Joomla necesita.

Creamos un nuevo archivo de configuración en Nginx:

sudo nano /etc/nginx/sites-available/joomla

Pega el siguiente bloque de código. Asegúrate de cambiar tu_dominio.com por tu dominio real (o la IP de tu servidor si aún no tienes DNS propagados):

server {
    listen 80;
    listen [::]:80;
    server_name tu_dominio.com www.tu_dominio.com;
    root /var/www/html/joomla;
    index index.php index.html index.htm;

    # Log files
    access_log /var/log/nginx/joomla.access.log;
    error_log /var/log/nginx/joomla.error.log;

    # Regla de Reescritura principal para URLs Amigables de Joomla (SEF)
    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    # Denegar acceso directo a directorios de sistema
    location ~* /(administrator/components|administrator/language|administrator/manifests|administrator/modules|administrator/templates|components|language|layouts|libraries|manifests|media|modules|plugins|templates)/ {
        deny all;
    }

    # Pasar scripts PHP a PHP-FPM
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Cacheo de estáticos (Opcional pero recomendado para optimizar Joomla en Nginx)
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires max;
        log_not_found off;
    }
}

Analizando el código: La directiva try_files $uri $uri/ /index.php?$args; es el equivalente al mod_rewrite de Apache. Le dice a Nginx que si no encuentra un archivo físico en la ruta solicitada, debe mandar la consulta al index.php de Joomla, permitiendo así que el CMS procese la URL amigable.

Habilita la configuración creando un enlace simbólico, prueba que no haya errores de sintaxis y reinicia Nginx:

sudo ln -s /etc/nginx/sites-available/joomla /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Paso 9: Finalizar la instalación desde el navegador

La infraestructura está lista. Ahora debemos conectar la interfaz de Joomla con nuestra base de datos MariaDB. Abre tu navegador web favorito y visita http://tu_dominio.com.

• Pantalla Principal: Selecciona tu idioma y el nombre de tu sitio.
• Datos de Login: Crea la cuenta de Super Usuario (Super Administrador). Define un email real, un nombre de usuario (¡nunca uses "admin"!) y una contraseña muy robusta.
• Configuración de Base de Datos:
  • Tipo de base de datos: MySQLi (Funciona perfectamente para MariaDB).
  • Hospedaje: localhost.
  • Usuario: joomla_user (el creado en el Paso 5).
  • Contraseña: La contraseña de base de datos que asignaste.
  • Nombre de la base de datos: joomla_db.
• Resumen Final: Haz clic en "Instalar". Tras unos segundos, Joomla construirá las tablas en MariaDB y configurará el archivo configuration.php.

Configuración Recomendada Después de Instalar Joomla

Saber cómo instalar Joomla es solo la mitad de la batalla de la administración de sistemas. Las siguientes implementaciones garantizan que tu web opere con estándares empresariales modernos.

Problemas comunes y soluciones (Troubleshooting)

Desplegar un stack LEMP tiene su curva de aprendizaje. Si encuentras errores, esta matriz de diagnóstico resolverá los bloqueos más habituales: