Strapi na VPS: como instalar o CMS headless passo a passo
Aprenda a instalar o Strapi 5 na sua VPS: requisitos, banco PostgreSQL, build e PM2, primeiro administrador, Nginx com HTTPS, atualização e backup do seu CMS headless.
Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Strapi na VPS: como instalar o CMS headless passo a passo Arte: Eleven Host
Strapi na VPS: o Strapi é um CMS headless de código aberto, escrito em JavaScript e TypeScript. Veja os requisitos, a instalação com PostgreSQL e PM2, o primeiro administrador, o HTTPS com Nginx, a atualização e o backup.
Aqui falamos do Strapi 5 (a versão 5.61.0 é a mais recente no GitHub em 04/11/2026). Se você está conhecendo o assunto, o guia O que é servidor VPS explica o básico do servidor onde o Strapi vai ficar.
O que é o Strapi
Segundo o próprio projeto, o Strapi é um CMS headless de código aberto.
A documentação do Strapi diz que as aplicações podem ser implantadas em servidores de hospedagem tradicionais ou no provedor de hospedagem de sua preferência.
A licença tem duas partes: a Community Edition usa a licença MIT, desde que você não use o diretório ee/ nem tenha conta registrada na oferta de nuvem do Strapi. Os recursos do diretório ee/ (Enterprise Edition) têm licença própria.
Se você usar algum componente do diretório ee/, a Enterprise Edition não está sob a MIT e segue a licença indicada pelo projeto.
Requisitos do Strapi 5
As tabelas da documentação separam o que é recomendado do que é o mínimo:
- Node.js: só versões LTS ativas ou em manutenção; no momento, v22, v24 e v26. Versões ímpares, como a v23 e a v25, não são suportadas;
- Gerenciador de pacotes: npm v6 ou mais recente, ou pnpm;
- Sistema operacional: Ubuntu LTS 24.04 (mínimo 20.04), Debian 11.x (mínimo 10.x) ou RHEL 10.x (mínimo 8.x); o Windows Server aparece como não suportado;
- Hardware: recomendados 2 ou mais núcleos de CPU, 4GB ou mais de RAM e 32GB ou mais de disco; o mínimo é 1 núcleo, 2GB de RAM e 8GB de disco;
- Ferramentas de compilação: em Debian e Ubuntu, o pacote
build-essential.
Para o banco de dados, a documentação lista MySQL (recomendado 8.4, mínimo 8.0), MariaDB (11.4, mínimo 10.3), PostgreSQL (17.0, mínimo 14.0) e SQLite 3. MongoDB e outros bancos NoSQL não são suportados. Ligar o Strapi a um banco que já existia e não foi criado por ele não é suportado; recomendamos usar um banco novo e vazio.
Os planos de VPS da Eleven Host já estão no seu radar? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
SQLite ou PostgreSQL
A CLI do Strapi usa o SQLite por padrão, com o arquivo em .tmp/data.db. A documentação o indica como o banco recomendado para criar uma aplicação rapidamente no seu computador. Para produção, a documentação indica que a aplicação costuma ser implantada com MySQL, MariaDB ou PostgreSQL.
Aqui usamos o PostgreSQL. O MySQL e o MariaDB também servem. No PostgreSQL, o usuário do banco precisa de permissão de SCHEMA; sem ela, o painel pode devolver erro 500 ao abrir.
Sem imagem Docker oficial
O projeto diz que não publica imagens de contêiner oficiais do Strapi. Existem ferramentas e imagens mantidas pela comunidade, como o pacote @strapi-community/dockerize, sem suporte oficial do Strapi.
Por isso a instalação a seguir é feita direto no servidor, sem contêiner.
Preparar o banco PostgreSQL
Instale o PostgreSQL (versão 14 ou mais recente) e crie um usuário e um banco para o Strapi. Um exemplo de comandos, para adaptar à sua senha:
sudo -u postgres psql
CREATE USER strapi WITH PASSWORD 'troque-esta-senha';
CREATE DATABASE strapi OWNER strapi;
GRANT ALL ON SCHEMA public TO strapi;
A primeira linha abre o psql; as outras são digitadas nele. A última cobre a permissão de SCHEMA que a documentação exige.
Criar o projeto
Instale o Node.js LTS par pelo método de sua preferência e confira com node --version. Instale também as ferramentas de compilação:
sudo apt install build-essential
node --version
O comando oficial para criar um projeto é npx create-strapi@latest. A CLI tem opções para responder às perguntas de antemão: --skip-cloud pula o login e a criação de projeto no Strapi Cloud, e --dbclient, --dbhost, --dbport, --dbname, --dbusername e --dbpassword definem o banco (ao usar algumas delas com um banco que não é o SQLite, é preciso informar todas). Um exemplo montado com essas opções:
sudo mkdir -p /srv && sudo chown "$USER" /srv && cd /srv
npx create-strapi@latest strapi --skip-cloud --dbclient postgres --dbhost 127.0.0.1 --dbport 5432 --dbname strapi --dbusername strapi --dbpassword 'troque-esta-senha'
O .env e o .env.example gerados trazem chaves de segurança criadas automaticamente e as configurações do banco.
Chaves e segredos do .env
A documentação descreve as principais variáveis:
APP_KEYS: chaves, separadas por vírgula, usadas para assinar cookies e outros segredos;API_TOKEN_SALT: sal usado ao criar tokens de API;ADMIN_JWT_SECRET: segredo dos tokens JWT do painel de administração.
Trocar o sal invalida os tokens de API existentes. Como recomendação nossa, guarde o .env no seu backup, não troque as chaves à toa e proteja o arquivo com chmod 600 .env e não o envie para um repositório Git.
Segredos fora do arquivo do PM2
A documentação do PM2 pede para não colocar segredos como APP_KEYS, ADMIN_JWT_SECRET ou credenciais do banco no arquivo de ecossistema. Eles ficam no .env do projeto.
Build e start em produção
O build do painel e a inicialização usam estes comandos da documentação:
NODE_ENV=production npm run build
NODE_ENV=production npm run start
Defina o NODE_ENV=production no próprio comando de build, e não para a sessão inteira do terminal, como pede a documentação. A porta padrão é a 1337.
A documentação recomenda fortemente um gerenciador de processos como o PM2. Instale-o e crie o arquivo ecosystem.config.js na pasta do projeto. O exemplo da documentação usa a pasta /srv/strapi; aqui trocamos o HOST para 127.0.0.1, para que o Strapi só atenda conexões do próprio servidor, com o Nginx na frente:
npm install -g pm2
module.exports = {
apps: [{
name: 'strapi',
cwd: '/srv/strapi',
script: 'npm',
args: 'start',
env: { NODE_ENV: 'production', HOST: '127.0.0.1', PORT: 1337 }
}]
};
Depois, suba e confira:
pm2 start ecosystem.config.js
pm2 list
curl -I http://localhost:1337/_health
Para o Strapi voltar sozinho após reiniciar o servidor, rode pm2 startup, que imprime um segundo comando para executar com sudo, e depois pm2 save.
Criar o primeiro administrador
Na primeira abertura do painel, em /admin, um formulário cria a conta do primeiro administrador do Strapi. Quem preencher esse formulário se torna o primeiro administrador.
Como o login só funciona por HTTPS em produção, o cadastro é feito depois que o Nginx e o certificado da próxima seção estiverem no ar. Como recomendação nossa, abra o endereço https://cms.exemplo.com/admin e preencha o formulário logo em seguida, antes de divulgar o endereço.
Nginx e HTTPS
O Strapi atende em HTTP simples e não termina o TLS sozinho. A documentação diz que, em produção, é preciso um certificado e um listener na porta 443, e cita o Certbot entre as opções para emitir o certificado. Ela também manda expor o painel por HTTPS em produção; desde a versão 5.24.0 os cookies do painel são seguros e HTTP-only, e o login por HTTP simples falha.
Um exemplo de bloco de servidor, a partir dos elementos que a documentação mostra (substitua cms.exemplo.com pelo seu domínio):
server {
listen 443 ssl;
server_name cms.exemplo.com;
# ssl_certificate e ssl_certificate_key do Certbot aqui
location / {
proxy_pass http://127.0.0.1:1337;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Emita o certificado antes de recarregar o Nginx; o Certbot é uma das opções. Um segundo bloco, na porta 80, redireciona para o HTTPS. Teste a configuração antes de recarregar, porque uma configuração quebrada derruba o site:
sudo nginx -t
sudo systemctl reload nginx
Se você prefere um painel para gerenciar o proxy, o guia Nginx Proxy Manager mostra como atender vários sites numa VPS só. Outra opção é o Caddy, que cuida do HTTPS de forma automática. Libere no firewall só as portas 22, 80 e 443, como recomendação nossa.
Com o proxy na frente, ajuste o config/server do projeto (.js ou .ts, conforme o seu projeto):
url: env('PUBLIC_URL', 'https://cms.exemplo.com'),
proxy: { koa: true, maxIpsCount: 1 },
O Strapi usa a url para montar endereços absolutos, como os dos e-mails de redefinição de senha e dos arquivos de mídia. Atenção: deixar o proxy.koa como true sem definir o proxy.maxIpsCount mantém a contagem no padrão 0, que significa sem limite, e deixa o Strapi confiar em cabeçalhos de IP falsos. Como mudar o config/server exige refazer o build do painel, rode de novo o build e reinicie:
NODE_ENV=production npm run build
pm2 restart strapi --update-env
Como atualizar o Strapi
Antes de atualizar, faça o backup do código e do banco, como pede a documentação (veja a seção de backup abaixo). A ferramenta de atualização do Strapi roda pelo npx. Os comandos são npx @strapi/upgrade major (próxima versão maior), minor, patch e latest. A opção -n (ou --dry) simula sem alterar arquivos.
npx @strapi/upgrade minor --dry
npx @strapi/upgrade minor
A documentação pede um backup do código e do banco antes de atualizar. A ferramenta altera o código do projeto, e a documentação recomenda fortemente revisar as modificações antes de rodar a aplicação de novo. Em produção, depois de atualizar, refaça o build e reinicie o processo:
NODE_ENV=production npm run build
pm2 restart strapi
As versões menores saem quase toda semana, então confira o que mudou antes de atualizar um site em uso.
Backup do Strapi
O Strapi traz o comando npm run strapi export. Ele leva a configuração do projeto, o conteúdo, as relações, os arquivos da pasta de uploads e os schemas. Mas usuários administradores e tokens de API não são exportados. Por isso, o export é um complemento, e não um backup completo.
Como recomendação nossa, o backup da instalação reúne quatro partes: o banco, a pasta public/uploads, o .env com as chaves e o código do projeto. Um exemplo para o banco e os uploads:
pg_dump -h 127.0.0.1 -U strapi strapi > strapi-banco.sql
tar czf strapi-uploads.tar.gz public/uploads
Leve as cópias para fora do servidor e teste a restauração num ambiente à parte.
Para importar, o comando é npm run strapi import -- -f arquivo. A documentação avisa que o import apaga os dados existentes, incluindo o banco e a pasta de uploads, antes de restaurar, e que a tabela de usuários administradores não é restaurada.
Antes de escolher o servidor
Compare os planos de VPS com os requisitos de CPU, RAM e disco da documentação do Strapi.
Você já tem um plano de servidor em mente? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
Qual é a licença do Strapi?
A Community Edition está sob a licença MIT, para quem não usa o diretório ee/ nem tem conta registrada no Strapi Cloud. Os recursos Enterprise têm licença própria.
Existe imagem Docker oficial do Strapi?
Não. O projeto diz que não publica imagens de contêiner oficiais. Há ferramentas e imagens da comunidade, sem suporte oficial.
Posso usar o SQLite em produção?
A documentação indica o SQLite para começar no computador local e cita MySQL, MariaDB ou PostgreSQL para a produção.
Qual versão do Node.js devo instalar?
Uma versão LTS par: no momento, a v22, a v24 ou a v26.