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 -yUma 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.iniAltere 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 mariadbUma 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 -pDigite 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.gitUma 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.ymlFaç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.phpAdicione 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=composerVocê 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 installEm 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/roadizConfigurar 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.confAdicione 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 -tFinalmente, 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-fpmAcessar 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:

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

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:

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:

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

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:

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

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

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:

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

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

Agora, remova o install.php do diretório raiz do documento do Roadiz com o seguinte comando:
rm -rf /var/www/html/roadiz/install.phpEm 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:

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

Parabéns! você instalou com sucesso o Roadiz no servidor Debian 10. Sinta-se à vontade para me perguntar se tiver alguma dúvida.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.