Twenty CRM na VPS: como instalar o CRM da empresa
Guia de Twenty CRM na VPS: requisitos, instalação manual com Docker Compose, a opção de versão fixa, proxy com HTTPS, backup, restauração e acompanhamento das versões.
Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: Twenty CRM na VPS: como instalar o CRM da empresa Arte: Eleven Host
Twenty CRM na VPS é a forma de manter o CRM de código aberto Twenty no seu próprio servidor, com Docker Compose. Veja o que é, os requisitos, a instalação manual, o proxy com HTTPS, o backup e as versões.
Atualizado em 06/11/2026. Na data deste guia, a v2.56.1, de 05/11, é a versão mais nova listada pelo projeto; confira se saiu outra. Os blocos marcados como exemplo são montados aqui: confira cada um no seu servidor antes de usar.
O que é o Twenty e para que serve um CRM
CRM é o sistema em que a empresa acompanha clientes e negociações. Segundo o GitHub do projeto, o Twenty é um CRM de código aberto que pode rodar na própria infraestrutura, com Docker Compose.
O projeto descreve duas formas de usar: a nuvem do fabricante, sem infraestrutura para cuidar e mantida atualizada, ou a auto-hospedagem, que é o assunto deste texto. Segundo a documentação do Twenty, quem prefere não manter o sistema pode procurar um parceiro certificado de hospedagem do Twenty.
Quem escolhe a auto-hospedagem assume o servidor, o backup e as atualizações. Se ainda está escolhendo o servidor, o guia completo de servidor VPS explica o que é uma VPS e como comparar os planos. Para ver outros sistemas de empresa instalados num servidor assim, há o guia de Dolibarr na VPS, ERP e CRM da empresa.
Requisitos antes de começar
A documentação do Twenty pede pelo menos 2 GB de RAM, e avisa que memória insuficiente pode derrubar processos. Pede também Docker e Docker Compose instalados e atualizados. Compare o requisito de memória com o que cada plano de VPS inclui, na loja.
Servidores virtuais estão na lista de pesquisa da equipe? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Passo 1: instalar o Docker
Instale o Docker pela página oficial de instalação, que usa o repositório do próprio Docker. A documentação do Docker não recomenda o script de conveniência para produção. Um exemplo de comando, depois de adicionar o repositório:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Três formas de instalar o Twenty
A documentação do Twenty traz uma opção de comando único, que instala a versão estável mais recente:
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
Para fixar a versão, a página manda informar a tag completa publicada no Docker Hub: apelidos como v2 ou latest não valem. O exemplo da página usa a v2.38.1, e você troca pela tag que quiser:
VERSION=v2.38.1 bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
Recomendamos ler o script antes de rodar. A terceira forma, a manual, é a que detalhamos a seguir: dá para ver cada arquivo antes de subir os serviços. O endereço dos arquivos dela aponta para o ramo main, sem versão fixa, e a opção com VERSION é a que fixa a versão.
Passo 2: baixar os arquivos e gerar as chaves
Numa pasta própria para o projeto, a documentação do Twenty indica baixar o modelo do .env e gerar dois valores aleatórios. O primeiro é o valor de ENCRYPTION_KEY; o segundo, o de PG_DATABASE_PASSWORD:
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
openssl rand -base64 32
openssl rand -hex 32
Depois, baixe o arquivo do Compose:
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml
O que mudar no .env antes de subir
A documentação manda modificar só o que ela indica, porque mudar outras configurações pode dar problema. Os pontos principais:
ENCRYPTION_KEY: use o primeiro valor gerado acima.PG_DATABASE_PASSWORD: use a senha gerada acima, sem caracteres especiais, porque@,/,#e%quebram a string de conexão.SERVER_URL: sem proxy, o formato éhttp://your-domain-or-ip:3000; com proxy,https://your-domain-or-ip. Uma variável sem padrão no Compose chega vazia ao servidor se faltar no.env, então mantenha esta preenchida.STORAGE_TYPE=S_3, com as variáveisSTORAGE_S3_*: opcional, só para quem usa armazenamento S3.
A lista completa de variáveis está na seção "Setup Environment Variables" da documentação do Twenty.
Segundo a documentação do Twenty, perder a ENCRYPTION_KEY significa perder o acesso a todo segredo guardado no banco. Recomendamos guardar uma cópia dela fora do servidor.
A configuração usa volumes para guardar os dados do banco e os arquivos do servidor. Entre os serviços estão o PostgreSQL, no contêiner twenty-postgres, o Redis, o server e o worker.
Passo 3: subir os serviços
Com o .env preenchido, suba os serviços:
docker compose up -d
Para conferir se o serviço responde na porta padrão, 3000, a documentação indica:
curl http://localhost:3000
Para aplicar uma mudança posterior no .env, rode docker compose down e depois docker compose up -d.
Proxy reverso e HTTPS
A documentação do Twenty recomenda fortemente um proxy reverso com terminação SSL. O HTTPS é exigido para alguns recursos do navegador, como a API da área de transferência. Antes de expor a instância à internet, ela manda ler a página "Securing your instance"; leia essa página inteira.
Com o Nginx instalado, um exemplo de bloco, com o domínio fictício crm.seudominio.com.br apontando para a porta 3000. Confira no seu servidor:
server {
listen 80;
server_name crm.seudominio.com.br;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Para o certificado, a página do Certbot indica estes comandos, o último simulando a renovação:
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/local/bin/certbot
sudo certbot --nginx
sudo certbot renew --dry-run
Com o proxy no ar, ajuste SERVER_URL para o formato com HTTPS e reinicie os serviços como descrito acima. Recomendamos conferir, de fora do servidor, se a porta 3000 ficou aberta. Segundo a documentação do Docker, o tráfego de contêiner publicado passa ao largo das regras do ufw; por isso, confira a seção ports do Compose e a documentação de firewall do Docker.
Primeiro acesso
Com o proxy e o HTTPS funcionando, abra o endereço no navegador e siga a tela de criação do espaço de trabalho que aparecer. Se o seu trabalho envolve atendimento ao cliente, o guia de Chatwoot na VPS, central de atendimento mostra outra ferramenta de empresa que roda em servidor próprio. Para campanhas e automação de marketing, há o guia de Mautic na VPS.
Backup e restauração
A documentação do Twenty traz um comando de backup do banco, que gera um arquivo com a data no nome:
docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql
Para agendar, a mesma documentação mostra uma linha do cron que roda às 2h:
0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql
Para restaurar, ela manda parar o server e o worker, importar o arquivo e subir de novo:
docker compose stop server worker
docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql
docker compose up -d
Cuidados com o backup
Recomendamos copiar o backup para fora da VPS, guardar o .env e a ENCRYPTION_KEY junto e testar a restauração em outra máquina. O dump cobre só o banco: os arquivos do servidor ficam em um volume à parte, que você confere no Compose.
Como acompanhar as versões
Na data deste guia, a página de lançamentos do projeto mostra a v2.56.1, de 05/11, que corrige uma falha de atualização que atingiu alguns espaços na v2.56. A v2.56.0, também de 05/11, lista uma mudança incompatível, e a v2.55.0 é de 03/11. As versões saem em sequência curta, por isso recomendamos ler as notas e fazer backup antes de atualizar.
Para o comando de atualização, siga a documentação de atualização do projeto.
Onde manter o CRM da empresa
O CRM de uma empresa pode ficar em um servidor próprio ou em um serviço de terceiros.
A VPS é uma alternativa que a equipe considera? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS
Perguntas frequentes
O Twenty é de código aberto?
Sim, segundo o GitHub do projeto, que o descreve como um CRM de código aberto.
Existe versão na nuvem?
Sim. O projeto descreve a nuvem do fabricante, sem infraestrutura para cuidar, e a auto-hospedagem.
O que acontece se eu perder a ENCRYPTION_KEY?
Segundo a documentação, você perde o acesso a todo segredo guardado no banco. Por isso, guarde uma cópia fora do servidor.
Posso instalar uma versão específica?
Sim. Use a opção com VERSION e informe a tag completa publicada no Docker Hub; apelidos como v2 ou latest não valem.