O Twenty (também chamado de TwentyCRM) é um CRM de código aberto que se apresenta como a alternativa aberta ao Salesforce, pensada para IA. Neste guia você entende o que ele faz, qual é a licença, o que muda entre a versão na nuvem e a instalada por você, e como instalar com Docker Compose.
O que descrevemos vem do repositório oficial, da documentação e do arquivo de licença, conferidos em 10/11/2026. Não instalamos o Twenty para escrever este artigo.
Resposta rápida
- **O que é:** um CRM de código aberto, no GitHub em twentyhq/twenty, para organizar contatos, empresas, negócios e processos de venda.
- **Para quem:** equipes que querem um CRM próprio, adaptável e versionado como o resto do sistema, e que aceitam cuidar da parte técnica.
- **Onde usar:** na nuvem oficial (twenty.com) ou instalado no seu servidor com Docker Compose.
- **Licença:** em geral AGPLv3, com arquivos marcados como Enterprise e pacotes sob MIT. Detalhes abaixo.
- **Requisito para instalar:** no mínimo 2 GB de memória, Docker e Docker Compose.
O que o Twenty faz
Segundo o README, o projeto reúne os blocos de um CRM moderno: objetos, visualizações, fluxos de trabalho (workflows) e agentes, que podem ser estendidos por código. Também há personalização de layouts, chat e agentes de IA, e as ferramentas padrão de CRM.
Uma ideia central é tratar o CRM como aplicativo definido em código: você descreve objetos, campos e visualizações, publica no seu workspace e controla as versões. Para quem não programa, a versão na nuvem permite criar o workspace em poucos minutos, sem cuidar de infraestrutura.
Por baixo, o projeto usa TypeScript, NestJS, PostgreSQL e Redis no servidor, e React na interface.
Nuvem ou instalação própria?
| | Nuvem (twenty.com) | Instalado por você |
|---|---|---|
| Quem cuida do servidor | O Twenty | Você |
| Atualizações | Automáticas | Você aplica |
| Controle dos dados | No serviço | No seu servidor |
| Esforço técnico | Baixo | Médio |
A própria documentação cita como vantagens da instalação própria o controle dos dados, o atendimento a exigências de localização dos dados e a personalização completa. Como o serviço na nuvem pode ter planos pagos, confira os valores atuais no site oficial antes de decidir.
Como instalar com Docker Compose
Requisitos: pelo menos 2 GB de memória, Docker e Docker Compose atualizados.
**Opção 1: script de uma linha**
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)**Opção 2: manual**
1. Baixe o arquivo de configuração:
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example2. Gere a chave de criptografia e coloque no `.env` como `ENCRYPTION_KEY`:
openssl rand -base64 323. Gere uma senha para o banco e coloque como `PG_DATABASE_PASSWORD`:
openssl rand -hex 324. Baixe o arquivo do Compose:
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml5. Suba os containers:
docker compose up -dDepois, abra `http://localhost:3000` se estiver no seu computador. Em um servidor, ajuste a variável `SERVER_URL` para o endereço que as pessoas vão abrir. Se mudar o `.env`, rode `docker compose down` e `docker compose up -d` de novo.
Cuidados antes de usar
- **Guarde a `ENCRYPTION_KEY`.** A documentação avisa que perdê-la significa perder o acesso aos segredos guardados.
- **Não compartilhe o arquivo `.env`.** Ele contém senhas e chaves.
- **Faça backup do banco.** O CRM guarda dados de clientes e, dependendo do uso, dados pessoais protegidos pela LGPD.
- **Proteja o acesso.** Em um servidor público, use HTTPS e não deixe a porta 3000 aberta sem controle.
- **Teste antes.** Experimente com dados de exemplo antes de importar a sua base de clientes.
Qual é a licença
O arquivo de licença informa que o projeto é, em geral, licenciado sob a AGPLv3. Há duas exceções: arquivos marcados no topo como Enterprise seguem uma licença comercial separada da Twenty.com, e alguns pacotes, como a CLI e o kit de desenvolvimento de aplicativos, usam a licença MIT.
Em linhas gerais, a AGPLv3 permite instalar e usar o programa. Recursos marcados como Enterprise dependem da licença comercial, então confira no site oficial o que cada plano inclui. Se você pretende modificar o código e oferecer o resultado como serviço para terceiros, leia a licença com atenção e, se for o caso, consulte um profissional.