Base de Conhecimento

Twenty CRM na VPS: como instalar o CRM da empresa

  • twenty crm, crm, docker compose, auto-hospedagem, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Twenty CRM na VPS: como instalar o CRM da empresa

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áveis STORAGE_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.

Esta resposta lhe foi útil?

Artigos Relacionados