Base de Conhecimento

Drupal na VPS: como instalar seu site com Composer

  • drupal, cms, vps, composer, php, mariadb
  • Usuários acharam útil: 0

Instale o Drupal numa VPS com Composer: versão estável, PHP, banco de dados, Apache ou Nginx, instalador, atualização, backup e as datas de fim de suporte.

Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Drupal na VPS: como instalar seu site com Composer

Capa da Redação Eleven Host para o guia: Drupal na VPS: como instalar seu site com Composer Arte: Eleven Host

O Drupal na VPS se instala com Composer, e a linha estável de hoje é a 11.4. Veja as versões de PHP e de banco que servem, o servidor web, o instalador, as permissões, a atualização e o backup, com as datas de fim de suporte.

Retrato de 05/11/2026. A versão estável mais nova da linha 11.4 é a 11.4.11, de 21/10/2026. O Drupal 12.0.0 e o 11.5.0 estão previstos para a semana de 07/12/2026 e, por enquanto, só existem em beta. O Drupal 10 chega ao fim da vida em 09/12/2026. Por isso, confira a página de releases antes de começar.

Que versão do Drupal instalar

A documentação define o Drupal como um software de gestão de conteúdo, com licença GNU GPL versão 2 ou posterior. Para o ambiente de produção, o caminho é uma versão estável:

  • 11.4.x: a linha mantida com novidades, hoje na 11.4.11. O calendário oficial marca 21/04/2027 como o último dia de suporte de segurança;
  • 11.3.x: a 11.3.20 recebe correções de segurança até dezembro de 2026, quando a 11.5.0 sair;
  • 10.6.x: a 10.6.20 acaba em 09/12/2026;
  • Drupal 7: o suporte de correções e de segurança terminou em 05/01/2025.

Versões recentes corrigiram uma falha crítica de execução remota de código e duas falhas de XSS (avisos SA-CORE-2026-014, 015 e 016, corrigidos nas versões 11.4.10, 11.3.19 e 10.6.19, segundo a página de releases). Recomendamos instalar a versão mais nova da linha que você escolher.

Em 05/11/2026, instale a linha 11.4. O Drupal 12 e o 11.5 só têm versões beta, e a documentação avisa que betas não se destinam à produção.

Requisitos do servidor

Se você ainda não tem uma VPS, o guia de servidor VPS explica o que é e como escolher. Para o Drupal, a documentação pede estes itens:

  • PHP: o Drupal 11.4 aceita o 8.3, o 8.4 e o 8.5; o Drupal 12.0 aceita só o 8.5. O 8.2 e o 8.6 não servem a nenhum dos dois. Quem pretende migrar para o Drupal 12 logo pode escolher o PHP 8.5 desde já;
  • extensões do PHP: PDO e um conector de banco (mysql, mysqli, pgsql ou SQLite), XML, GD ou ImageMagick para imagens e JSON; a OpenSSL é recomendada. A mbstring é indicada para sites em outros idiomas. A partir do Drupal 12.0, o PHP precisa ter sido compilado com argon2;
  • memória do PHP: o memory_limit mínimo é 64 MB, e sites em produção usam 128 MB ou 256 MB;
  • memória do servidor: mínimo de 1 GB de RAM. A página explica que o Composer chegou a usar cerca de 200 MB num site Drupal 10 com uns 30 módulos e aconselha manter 1 GB livre;
  • Composer: o Drupal 11 exige a versão 2.7.0 ou mais nova.

Para o banco, a tabela de requisitos do Drupal 11 pede MariaDB 10.6 ou superior, MySQL 8.0 ou superior, PostgreSQL 16 ou superior, ou SQLite 3.45 ou superior. Na prática, recomendamos instalar o MariaDB 10.11 ou mais novo, ou o MySQL 8.4: o MySQL 8.0 já chegou ao fim da vida em abril de 2026, e o MariaDB 10.6 saiu da manutenção comunitária em 06/07/2026. As duas opções também atendem ao Drupal 12. A documentação recomenda o nível de isolamento de transação READ COMMITTED.

Crie o banco de dados

Os comandos abaixo vêm da documentação de instalação do Drupal, com o GRANT simplificado. Troque databasename, username e password pelos seus valores:

mysql -u username -p -e "CREATE DATABASE databasename CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci";

mysql -u username -p

CREATE USER username@localhost IDENTIFIED BY 'password';

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES ON databasename.* TO 'username'@'localhost';

Ao terminar, saia do cliente com exit. Para restaurar um dump feito pelo Drush, a conta também precisa do privilégio LOCK TABLES. Se o nome do banco tiver sublinhado, escape-o como \_ no GRANT, porque o sublinhado funciona como curinga.

Baixe o Drupal com Composer

Antes, instale no servidor o PHP com as extensões da lista acima, o Composer, o banco e o servidor web, pelo gerenciador de pacotes da sua distribuição. O projeto recomendado do Drupal nasce com um único comando:

composer create-project drupal/recommended-project my_site_name

Esse modelo cria a raiz relocada: o index.php e a pasta core ficam em web, e a pasta vendor fica fora da raiz do site. Um exemplo de comandos, para conferir no seu servidor. Eles criam a pasta do projeto com o usuário do servidor web como dono e rodam o Composer como esse usuário:

cd /var/www

sudo install -d -o www-data -g www-data meusite

sudo -u www-data composer create-project drupal/recommended-project meusite

O Drush não vem no modelo. Para tê-lo, rode composer require drush/drush dentro do projeto e use drush site:install se preferir instalar pelo terminal. Os comandos drush mais abaixo supõem o Drush disponível no terminal; dentro do projeto, o executável fica em vendor/bin/drush. Num projeto que já existe e vai para a produção, a documentação manda incluir a opção --no-dev:

composer install --no-dev

Ficou com dúvida sobre o servidor? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Aponte o servidor web para a pasta web

A raiz do servidor web é a pasta web do projeto, e não a pasta do projeto inteira. Com o Apache, a documentação pede a versão 2.4.7 ou superior, o módulo mod_rewrite e a diretiva AllowOverride All no virtual host. Se o MultiViews estiver ligado, inclua Options -MultiViews. Um exemplo de virtual host com essas diretivas, para ajustar e conferir no seu servidor:

<VirtualHost *:80>

ServerName exemplo.com.br

DocumentRoot /var/www/meusite/web

<Directory /var/www/meusite/web>

AllowOverride All

Options -MultiViews

Require all granted

</Directory>

</VirtualHost>

Para ativar o virtual host no Apache em Debian ou Ubuntu, um exemplo de comandos, supondo que você o salvou como /etc/apache2/sites-available/meusite.conf:

sudo a2enmod rewrite

sudo a2ensite meusite

sudo apache2ctl configtest

sudo systemctl reload apache2

Para o Nginx, a documentação exige a versão 1.1 ou superior. Um exemplo de configuração com o PHP-FPM, que não é oficial e deve ser conferido e adaptado ao seu servidor. O caminho do socket em fastcgi_pass muda conforme a versão do PHP, então confira o do seu:

server {

listen 80;

server_name exemplo.com.br;

root /var/www/meusite/web;

index index.php;

location / {

try_files $uri /index.php?$query_string;

}

location ~ /\.(?!well-known) {

deny all;

}

location ~ ^/sites/[^/]+/files/.*\.php$ {

deny all;

}

location ~ '\.php$|^/update\.php' {

fastcgi_split_path_info ^(.+?\.php)(|/.*)$;

include fastcgi_params;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

fastcgi_param PATH_INFO $fastcgi_path_info;

fastcgi_pass unix:/run/php/php-fpm.sock;

}

}

Para ativar o exemplo do Nginx, salve-o como /etc/nginx/sites-available/meusite e rode estes comandos de exemplo:

sudo ln -s /etc/nginx/sites-available/meusite /etc/nginx/sites-enabled/meusite

sudo nginx -t

sudo systemctl reload nginx

O Nginx não lê arquivos .htaccess, e a documentação do Drupal protege as pastas de arquivos com um deles. Por isso o bloco acima traz uma regra que bloqueia a execução de PHP em sites/*/files. Veja também o guia do Laravel na VPS, que mostra a publicação de outro projeto PHP com Nginx. Se pretende colocar vários sites na mesma VPS, o guia do Nginx Proxy Manager mostra uma forma de organizá-los.

Rode o instalador

Com o domínio apontando para o servidor, abra o site no navegador. A documentação diz que você será redirecionado para a página do instalador, em /core/install.php. Se ainda falta o domínio, o guia Como criar site leva do domínio até o site no ar. O Guia do Usuário descreve estas etapas:

  1. escolher o idioma;
  2. escolher o perfil Standard;
  3. conferir os requisitos;
  4. informar os dados do banco criado antes;
  5. aguardar o progresso da instalação;
  6. definir o nome do site, o e-mail e a conta de administrador.

Confira o estado do site

Depois da instalação, abra Administração, Relatórios, Relatório de status (Reports, Status report) e leia os avisos. Em seguida, a documentação manda proteger o arquivo de configurações e a pasta de arquivos. Um exemplo de comandos, rodados a partir da pasta do projeto, com os caminhos do modelo recomendado, para conferir no seu servidor:

chmod u+w web/sites/default/settings.php

chmod a-w web/sites/default/settings.php

chown -R www-data web/sites/default/files

Entre os dois primeiros comandos, inclua os hosts confiáveis no settings.php. A documentação mostra o formato abaixo, e quem acessa o site por um nome fora do padrão recebe um erro HTTP 400:

$settings['trusted_host_patterns'] = [

'^www\.example\.com$',

];

Se não puder mudar o dono da pasta de arquivos, a documentação sugere chmod -R 0770 nela.

Atualize o Drupal

Antes de atualizar, deixe o relatório de status sem erros e faça um backup. A documentação de atualização pelo Composer traz esta sequência:

composer outdated "drupal/*"

composer update drush/drush

composer update "drupal/core-*" --with-all-dependencies

drush updatedb

drush cache:rebuild

Se quiser, ligue o modo de manutenção antes com drush state:set system.maintenance_mode 1.

Backup do site

O guia oficial de backup cita estes comandos do Drush:

drush archive:dump --destination=testing-updates.tar.gz

drush archive:restore testing-updates.tar.gz

drush sql:dump

O banco guarda o conteúdo e os dados dos usuários, e os arquivos enviados também entram na cópia.

Guarde a cópia fora do servidor

A documentação recomenda guardar os backups em locais externos e seguros e ter um procedimento de volta atrás testado. Recomendamos restaurar uma cópia de ensaio antes de precisar dela.

Para quem ainda vai escolher o servidor

A loja mostra os planos de VPS e o preço de cada um.

Os valores das VPS cabem no seu orçamento? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Comparar os planos

Perguntas frequentes

Posso instalar o Drupal 12 hoje?

Não para produção. Em 05/11/2026, o Drupal 12.0.0 e o 11.5.0 só têm versões beta, que a documentação avisa não se destinarem à produção, e o lançamento está previsto para a semana de 07/12/2026.

Qual versão do PHP usar com o Drupal 11.4?

A tabela da documentação aceita o PHP 8.3, 8.4 e 8.5. Como o Drupal 12.0 só aceita o 8.5, esse é o caminho para quem pretende migrar logo.

Preciso do Composer?

Neste caminho, sim. O projeto recomendado, as dependências e as atualizações passam por ele, na versão 2.7.0 ou mais nova para o Drupal 11.

Até quando o Drupal 10 recebe atualizações?

Até 09/12/2026, quando chega ao fim da vida segundo a documentação.

Dá para usar Nginx em vez de Apache?

Sim. A documentação pede o Nginx 1.1 ou superior. O bloco de configuração mostrado acima não é oficial e deve ser conferido antes de ir para a produção.

Esta resposta lhe foi útil?

Artigos Relacionados