Drupal na VPS: como instalar seu site com Composer
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

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_limitmí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:
- escolher o idioma;
- escolher o perfil Standard;
- conferir os requisitos;
- informar os dados do banco criado antes;
- aguardar o progresso da instalação;
- 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.