Base de Conhecimento

Strapi na VPS: como instalar o CMS headless passo a passo

  • strapi, cms headless, nodejs, postgresql, pm2, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Strapi na VPS: como instalar o CMS headless passo a passo

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.

Esta resposta lhe foi útil?

Artigos Relacionados