Instalação CMS · 5 min read · Oct 20, 2025

Como Instalar o CMS Roadiz baseado em Node com Nginx no Debian

Roadiz é um sistema de gerenciamento de conteúdo gratuito e de código aberto baseado em um sistema de nós. O Roadiz permite que você crie seu próprio esquema de dados do zero e organize seu conteúdo conforme sua necessidade. O Roadiz é especialmente projetado para designers e desenvolvedores construírem experiências sólidas juntos. O Roadiz utiliza uma interface de gerenciamento de documentos centralizada que pode ser usada para armazenar todas as suas imagens, vídeos e PDFs. O Roadiz permite que você altere vários temas para uma base de conteúdo.

Neste tutorial, aprenderemos como instalar o Roadiz em um servidor Debian 11.

Requisitos

  • Um servidor rodando Debian 11.
  • Uma senha de root configurada em seu servidor.

Instalar Nginx, PHP, MariaDB

Primeiro, você deve instalar o servidor web Nginx, o servidor de banco de dados MariaDB, PHP e outras extensões PHP necessárias em seu servidor. Você pode instalar todos eles com o seguinte 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

Uma vez que todos os pacotes necessários estejam instalados, abra o arquivo php.ini e faça as alterações necessárias:

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

Altere as seguintes linhas:

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

Salve e feche o arquivo. Em seguida, inicie o serviço Nginx e MariaDB e habilite-os para iniciar após a reinicialização com o seguinte comando:

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

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Configurar o Banco de Dados para o Roadiz

Em seguida, você precisará criar um banco de dados, um usuário de banco de dados e uma senha para o Roadiz.

Para fazer isso, faça login no shell do MariaDB com o seguinte comando:

mysql -u roo -p

Digite sua senha de root e, em seguida, crie um banco de dados e um usuário para o Roadiz com o seguinte comando:

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

Em seguida, limpe os privilégios e saia do shell do MariaDB com o seguinte comando:

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

Uma vez que o banco de dados tenha sido criado, você pode prosseguir para a próxima etapa.

Instalar o Roadiz

Primeiro, você precisará baixar a versão mais recente do Roadiz do repositório Git para o diretório raiz do documento do Nginx. Você pode baixá-lo com o seguinte comando:

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

Uma vez que o download esteja completo, mude o diretório para roadiz e abra o arquivo config.mysql.travis.yml:

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

Faça as seguintes alterações de acordo com seu banco de dados:

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

Salve e feche o arquivo quando terminar.

Em seguida, abra o arquivo index.php e defina seu endereço IP na seção AllowedIP:

nano install.php

Adicione seu endereço IP conforme mostrado abaixo:

$allowedIp = [
    '10.0.2.2',     // vagrant host (forwarded)
    '192.168.33.1', // vagrant host (private)
    '127.0.0.1', 'fe80::1', '::1', ':ffff:127.0.0.1', '::ffff:127.0.0.1', 'YOUR-IP-ADDRESS'
];

Salve e feche o arquivo. Em seguida, você precisará instalar o Composer para instalar as dependências PHP necessárias. Você pode instalá-lo com o seguinte comando:

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

Você deve ver a seguinte saída:

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

Em seguida, instale todas as dependências PHP necessárias com o seguinte comando:

composer install

Em seguida, dê as permissões adequadas ao diretório roadiz:

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

Configurar Nginx para o Roadiz

Em seguida, crie um arquivo de host virtual do Nginx para o Roadiz. Você pode fazer isso criando o arquivo roadiz.conf no diretório /etc/nginx/sites-available/.

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

Adicione as seguintes linhas:

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;
     }
}

Salve e feche o arquivo. Em seguida, habilite o arquivo de host virtual com o seguinte comando:

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

Em seguida, teste o Nginx para qualquer erro de sintaxe com o seguinte comando:

ginx -t

Finalmente, reinicie o Nginx e o serviço PHP-FPM para aplicar todas as alterações de configuração:

systemctl restart nginx  
systemctl restart php7.4-fpm

Acessar o Painel do Roadiz

Agora, abra seu navegador web e digite a URL http://example.com/install.php. Você será redirecionado para a seguinte página:

Instalação do Roadiz

Selecione seu idioma e clique em Requisitos. Você deve ver a seguinte página:

Requisitos

Certifique-se de que todas as extensões necessárias estão instaladas. Em seguida, clique no botão Banco de Dados. Você deve ver a seguinte página:

Configurações do banco de dados

Em seguida, forneça os detalhes do seu banco de dados e clique no botão Construir banco de dados. Você deve ver a seguinte página:

Banco de dados instalado

Em seguida, clique no botão Tema. Você deve ver a seguinte página:

Informações do site

Em seguida, forneça o nome do seu site, endereço de e-mail e clique no botão Salvar informações. Você deve ver a seguinte página:

Configuração do tema

Em seguida, clique no botão Executar instalação do tema. Você deve ver a seguinte página:

Importar conteúdo do tema

Em seguida, clique no botão Usuário para criar um usuário administrador. Você deve ver a seguinte página:

Criar usuário administrador

Em seguida, forneça os detalhes do seu usuário administrador e clique no botão Criar usuário. Você deve ver a seguinte página:

usuário criado

Em seguida, clique no botão Concluído. Você deve ver a seguinte página:

Roadiz instalado com sucesso

Agora, clique no botão Sair da instalação. Você deve ver a seguinte página:

Sucesso

Agora, remova o install.php do diretório raiz do documento do Roadiz com o seguinte comando:

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

Em seguida, abra seu navegador web e acesse sua interface de administração com a URL http://example.com/rz-admin. Você será redirecionado para a página de login do Roadiz:

Login no Roadiz

Forneça seus dados de login e clique no botão Entrar. Você deve ver o painel do Roadiz na seguinte página:

Painel do Roadiz

Parabéns! você instalou com sucesso o Roadiz no servidor Debian 10. Sinta-se à vontade para me perguntar se tiver alguma dúvida.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.