Instalación CMS · 5 min read · Oct 20, 2025

Cómo instalar Roadiz CMS basado en Node con Nginx en Debian

Roadiz es un sistema de gestión de contenido gratuito y de código abierto basado en un sistema de nodos. Roadiz te permite crear tu propio esquema de datos desde cero y organizar tu contenido según tus necesidades. Roadiz está diseñado especialmente para que diseñadores y desarrolladores construyan experiencias sólidas juntos. Roadiz utiliza una interfaz de gestión de documentos centralizada que se puede usar para almacenar todas tus imágenes, videos y PDFs. Roadiz te permite cambiar múltiples temas para una base de contenido.

En este tutorial, aprenderemos cómo instalar Roadiz en un servidor Debian 11.

Requisitos

  • Un servidor que ejecute Debian 11.
  • Una contraseña de root configurada en tu servidor.

Instalar Nginx, PHP, MariaDB

Primero, debes instalar el servidor web Nginx, el servidor de base de datos MariaDB, PHP y otras extensiones de PHP requeridas en tu servidor. Puedes instalar todos ellos con el siguiente comando:

apt-get install -y nginx mariadb-server php php-cli php-fpm php-common php-mysql php-mbstring php-gd php-intl php-xml php-curl php-zip php-pgsql php-sqlite3 php-opcache php-apcu curl unzip wget -y

Una vez que todos los paquetes requeridos estén instalados, abre el archivo php.ini y realiza los cambios necesarios:

nano /etc/php/7.4/fpm/php.ini

Cambia las siguientes líneas:

memory_limit = 128M 
post_max_size = 16M 
upload_max_filesize = 16M 
date.timezone = Asia/Kolkata

Guarda y cierra el archivo. Luego, inicia el servicio de Nginx y MariaDB y habilítalos para que se inicien después del reinicio con el siguiente comando:

systemctl start nginx  
systemctl enable nginx  
systemctl start mariadb  
systemctl enable mariadb

Una vez que hayas terminado, puedes proceder al siguiente paso.

Configurar la base de datos para Roadiz

A continuación, necesitarás crear una base de datos, un usuario de base de datos y una contraseña para Roadiz.

Para hacerlo, inicia sesión en el shell de MariaDB con el siguiente comando:

mysql -u roo -p

Ingresa tu contraseña de root y luego crea una base de datos y un usuario para Roadiz con el siguiente comando:

MariaDB [(none)]> CREATE DATABASE roadizdb;  
MariaDB [(none)]> GRANT ALL ON roadizdb.* TO 'roadiz' IDENTIFIED BY 'password';

A continuación, actualiza los privilegios y sal del shell de MariaDB con el siguiente comando:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Una vez que se ha creado la base de datos, puedes proceder al siguiente paso.

Instalar Roadiz

Primero, necesitarás descargar la última versión de Roadiz desde el repositorio de Git al directorio raíz del documento de Nginx. Puedes descargarlo con el siguiente comando:

cd /var/www/html/  
git clone https://github.com/roadiz/roadiz.git

Una vez que la descarga se haya completado, cambia el directorio a roadiz y abre el archivo config.mysql.travis.yml:

cd roadiz  
nano conf/config.mysql.travis.yml

Realiza los siguientes cambios según tu base de datos:

    driver: "pdo_mysql"
    host: "localhost"
    user: "roadiz"
    password: "password"
    dbname: "roadizdb"

Guarda y cierra el archivo cuando hayas terminado.

A continuación, abre el archivo index.php y define tu dirección IP en la sección AllowedIP:

nano install.php

Agrega tu dirección IP como se muestra a continuación:

$allowedIp = [
    '10.0.2.2',     // host de vagrant (reenviado)
    '192.168.33.1', // host de vagrant (privado)
    '127.0.0.1', 'fe80::1', '::1', ':ffff:127.0.0.1', '::ffff:127.0.0.1', 'TU-DIRECCIÓN-IP'
];

Guarda y cierra el archivo. Luego, necesitarás instalar Composer para instalar las dependencias de PHP requeridas. Puedes instalarlo con el siguiente comando:

curl -sS https://getcomposer.org/installer -o composer-setup.php php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Deberías ver la siguiente salida:

All settings correct for using Composer
Downloading...

Composer (version 1.8.6) successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer

A continuación, instala todas las dependencias de PHP requeridas con el siguiente comando:

composer install

A continuación, otorga los permisos adecuados al directorio roadiz:

chown -R www-data:www-data /var/www/html/roadiz  
chmod -R 755 /var/www/html/roadiz

Configurar Nginx para Roadiz

A continuación, crea un archivo de host virtual de Nginx para Roadiz. Puedes hacerlo creando el archivo roadiz.conf en el directorio /etc/nginx/sites-available/.

nano /etc/nginx/sites-available/roadiz.conf

Agrega las siguientes líneas:

server {
    listen 80;
    listen [::]:80;

    server_name example.com;             
    root /var/www/html/roadiz/;             

    index index.php;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ ^/(dev|install|preview|clear_cache)\.php(/|$) {
        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
    }

    location ~ ^/index\.php(/|$) {
        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
        internal;
     }
}

Guarda y cierra el archivo. Luego, habilita el archivo de host virtual con el siguiente comando:

ln -s /etc/nginx/sites-available/roadiz.conf /etc/nginx/sites-enabled/

A continuación, prueba Nginx para cualquier error de sintaxis con el siguiente comando:

ginx -t

Finalmente, reinicia Nginx y el servicio PHP-FPM para aplicar todos los cambios de configuración:

systemctl restart nginx  
systemctl restart php7.4-fpm

Acceder al panel de control de Roadiz

Ahora, abre tu navegador web y escribe la URL http://example.com/install.php. Serás redirigido a la siguiente página:

Instalación de Roadiz

Selecciona tu idioma y haz clic en Requisitos. Deberías ver la siguiente página:

Requisitos

Asegúrate de que todas las extensiones requeridas estén instaladas. Luego, haz clic en el botón Base de datos. Deberías ver la siguiente página:

Configuraciones de base de datos

A continuación, proporciona los detalles de tu base de datos y haz clic en el botón Construir base de datos. Deberías ver la siguiente página:

Base de datos instalada

A continuación, haz clic en el botón Tema. Deberías ver la siguiente página:

Información del sitio

A continuación, proporciona el nombre de tu sitio, dirección de correo electrónico y haz clic en el botón Guardar información. Deberías ver la siguiente página:

Configuración del tema

A continuación, haz clic en el botón Realizar instalación del tema. Deberías ver la siguiente página:

Importar contenido del tema

A continuación, haz clic en el botón Usuario para crear un usuario administrador. Deberías ver la siguiente página:

Crear usuario administrador

A continuación, proporciona los detalles de tu usuario administrador y haz clic en el botón Crear usuario. Deberías ver la siguiente página:

usuario creado

A continuación, haz clic en el botón Hecho. Deberías ver la siguiente página:

Roadiz instalado con éxito

Ahora, haz clic en el botón Salir de la instalación. Deberías ver la siguiente página:

Éxito

Ahora, elimina el install.php del directorio raíz del documento de Roadiz con el siguiente comando:

rm -rf /var/www/html/roadiz/install.php

A continuación, abre tu navegador web y accede a tu interfaz de administración con la URL http://example.com/rz-admin. Serás redirigido a la página de inicio de sesión de Roadiz:

Iniciar sesión en Roadiz

Proporciona tus datos de inicio de sesión y haz clic en el botón Iniciar sesión. Deberías ver el panel de control de Roadiz en la siguiente página:

Panel de control de Roadiz

¡Felicidades! has instalado con éxito Roadiz en el servidor Debian 10. No dudes en preguntarme si tienes alguna pregunta.

Share: X/Twitter LinkedIn

Recibe nuevas publicaciones en tu bandeja de entrada.

No spam. Cancela la suscripción en cualquier momento.