Typebot na VPS: como instalar seu criador de chatbots
Aprenda a instalar o Typebot no seu servidor com Docker Compose, preencher o .env, configurar o login, ligar o HTTPS com proxy reverso e atualizar com cuidado.
Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: Typebot na VPS: como instalar seu criador de chatbots Arte: Eleven Host
O Typebot na VPS é um criador de chatbots visual, com licença FSL, que você monta no navegador e coloca nos seus sites e apps. Na sua VPS, ele sobe com Docker Compose em duas partes: o builder e o viewer.
O que é o Typebot e qual é a licença
O Typebot é um construtor de chatbots. Você desenha a conversa de forma visual, embute o bot em um site ou aplicativo e acompanha as respostas dos usuários em tempo real. O README do projeto o descreve como feito para desenvolvedores, com APIs e flexibilidade.
O projeto se apresenta como "fair source". O README diz que o código é protegido pela Functional Source License, e o arquivo LICENSE traz a versão 1.1 com licença futura Apache 2.0. Isso não é a mesma coisa que open source. Em resumo, pela licença, o propósito permitido é o que não seja um uso concorrente, e um uso concorrente é oferecer o software a terceiros em um produto ou serviço comercial parecido com ele. A licença futura Apache 2.0 passa a valer depois de dois anos de cada versão publicada.
A documentação do Typebot permite criar e publicar bots nos produtos da sua empresa, mas não permite vender acesso à sua instância nem oferecer serviço de hospedagem de Typebot para outras pessoas.
Por isso, use a sua instalação para os seus próprios bots. Em caso de dúvida sobre uso comercial, consulte um profissional.
Antes de começar
A documentação de instalação pede um servidor com Docker instalado. O Typebot também precisa de um banco PostgreSQL, mas você não precisa criá-lo à mão: o arquivo Compose oficial já traz um Postgres 16 e um Redis. A documentação não informa requisitos de memória, processador ou disco, então acompanhe o consumo do servidor depois de subir.
Se você está conhecendo servidores agora, leia antes o guia de iniciantes sobre servidor VPS.
Separe também dois endereços, um para o builder e outro para o viewer, por exemplo typebot.exemplo.com e bot.exemplo.com, ambos apontados para o IP da VPS. E tenha à mão um serviço de SMTP, que você vai usar no login (veja mais abaixo).
Baixar o compose e o arquivo .env
O repositório oficial publica o docker-compose.yml e um .env.example. A documentação manda baixar os dois com o wget:
wget https://raw.githubusercontent.com/baptisteArno/typebot.io/latest/docker-compose.yml
wget https://raw.githubusercontent.com/baptisteArno/typebot.io/latest/.env.example -O .env
O segundo comando já salva o exemplo com o nome .env. Para gerar o segredo de criptografia, a documentação traz este comando:
openssl rand -base64 24 | tr -d '\n' ; echo
O arquivo .env.example traz estas variáveis para você preencher:
ENCRYPTION_SECRET=cole-aqui-o-segredo-gerado
DATABASE_URL=postgresql://postgres:typebot@typebot-db:5432/typebot
NODE_OPTIONS=--no-node-snapshot
NEXTAUTH_URL=https://typebot.exemplo.com
NEXT_PUBLIC_VIEWER_URL=https://bot.exemplo.com
ADMIN_EMAIL=voce@exemplo.com
O que cada uma faz, segundo a página de configuração:
ENCRYPTION_SECRETé a chave usada para criptografar dados sensíveis. O comentário do arquivo pede uma string aleatória própria de 32 caracteres, e o valor deve ser o mesmo no builder e no viewer.NEXTAUTH_URLé o endereço público do builder.NEXT_PUBLIC_VIEWER_URLé o endereço público do viewer.ADMIN_EMAILé o e-mail que ganha acesso total de administrador quando o usuário é criado.
Nos exemplos acima, os endereços usam exemplo.com; troque pelo seu domínio. Se preferir, a variável DISABLE_SIGNUP desliga novos cadastros, e usuários convidados continuam podendo entrar.
Troque a senha do Postgres nos dois lugares
O compose oficial cria o banco com a senha typebot (POSTGRES_PASSWORD=typebot), e a DATABASE_URL do .env usa a mesma senha. Por isso, recomendamos trocá-la nos dois arquivos, e com o mesmo valor, antes de subir pela primeira vez.
Subir o Typebot com Docker Compose
Com o .env preenchido, suba os serviços. A documentação do Typebot usa a sintaxe antiga, docker-compose, com hífen. No Docker atual, o comando é docker compose, com espaço, e é esse que usamos daqui em diante:
docker compose up -d
Segundo a documentação, esse comando cria o banco e roda as migrações. O compose declara volumes do Docker, como o db-data do Postgres e o redis-data do Redis.
O compose publica o builder na porta 8080 e o viewer na porta 8081 do servidor. Dentro dos contêineres, os dois usam a porta 3000.
Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS
O login pede SMTP ou outro provedor
O Typebot não tem usuário e senha padrão. Para entrar, você precisa configurar ao menos um provedor de login. A documentação lista e-mail, Google, GitHub, Facebook e GitLab.
A seção de e-mail da página de configuração serve para notificações e para autenticação. Na prática, isso significa que, sem SMTP configurado, o login por e-mail não funciona. Se for usar o e-mail, use um serviço de SMTP e preencha estas variáveis:
SMTP_HOSTeSMTP_PORT(a porta padrão é 25).SMTP_USERNAMEeSMTP_PASSWORD.SMTP_SECURE(padrão false).NEXT_PUBLIC_SMTP_FROM, com o nome e o e-mail do remetente.
A documentação também mostra como usar um serviço SMTP dentro do próprio compose, com SPF e DNS reverso configurados. Existe ainda a variável SMTP_AUTH_DISABLED, que desliga o login por e-mail e mantém as notificações. Se preferir outro provedor de login, consulte a página de configuração para as variáveis de cada um.
Depois de configurar o login, abra o builder e entre com o e-mail definido em ADMIN_EMAIL. Nos exemplos da documentação, o endereço tem o formato http://typebot.exemplo.com:8080.
Dois endereços e HTTPS com proxy reverso
O Typebot serve apenas HTTP e não cuida do certificado. A documentação manda colocar um proxy reverso na frente, e cita a Cloudflare ou o Caddy como opções. Você precisa de registros DNS do tipo A para o endereço do builder e para o do viewer, e os dois devem apontar para o IP da VPS.
Com um proxy próprio, os endereços do proxy devem bater com NEXTAUTH_URL e NEXT_PUBLIC_VIEWER_URL, encaminhando para 127.0.0.1:8080 (builder) e 127.0.0.1:8081 (viewer). No viewer, a documentação pede o ajuste flush_interval -1 para o envio das mensagens em fluxo.
O guia Nginx Proxy Manager: vários sites numa VPS só mostra um painel para isso. Se preferir um servidor web com certificado automático, veja o Caddy na VPS.
Uma adaptação nossa: como o proxy fica na mesma VPS, mude as portas do compose para que só a própria máquina as acesse. No arquivo, troque as linhas de portas por estas:
- "127.0.0.1:8080:3000"
- "127.0.0.1:8081:3000"
O UFW não fecha uma porta publicada pelo Docker. Para ver o que está aberto no servidor, o guia Portas abertas no Linux ajuda. Depois de editar o compose, rode docker compose up -d de novo.
Atualizar o Typebot
A atualização é manual. A documentação indica puxar as imagens do builder e do viewer, derrubar os serviços e subir de novo (aqui já com o docker compose):
docker compose pull typebot-builder
docker compose pull typebot-viewer
docker compose down
docker compose up -d
O compose usa a etiqueta latest. Para controlar a versão, a documentação mostra como trocar latest por uma etiqueta fixa nas duas imagens. O exemplo dela usa a 3.4.2; na página de releases do projeto, a v3.19.1, de 20 de outubro, aparece como a mais recente. Use a etiqueta da release que você escolher.
Segundo a documentação, a versão hospedada por você recebe as mudanças mais ou menos um mês depois da versão em nuvem. Antes de atualizar, copie o banco e o .env, como explicamos abaixo.
Backup
A documentação de instalação não traz uma seção de backup. Ela diz que, ao hospedar, instalação, atualizações, backups e segurança ficam com você. Na prática, isso significa guardar uma cópia do banco PostgreSQL (o volume db-data) e do arquivo .env, de preferência fora da VPS. Guarde o ENCRYPTION_SECRET junto com a cópia do .env.
Integrações e armazenamento
O README lista estas integrações: Webhook e requisições HTTP, OpenAI, Google Sheets, Google Analytics, Meta Pixel, Zapier, Make.com e Chatwoot. A documentação também permite guardar arquivos em um armazenamento compatível com S3, com variáveis como S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET e S3_ENDPOINT.
Checklist depois de instalar
- Troquei a senha do Postgres no compose e na
DATABASE_URL. - Gerei um
ENCRYPTION_SECRETpróprio e guardei uma cópia do.envfora da VPS. - Preenchi
NEXTAUTH_URLeNEXT_PUBLIC_VIEWER_URLcom os endereços públicos, em HTTPS. - Configurei um serviço de SMTP ou outro provedor de login.
- Entrei com o e-mail do
ADMIN_EMAIL. - Publiquei as portas 8080 e 8081 só em
127.0.0.1e coloquei um proxy com HTTPS na frente. - Defini uma etiqueta de versão para as imagens.
- Faço backup do banco antes de atualizar.
Vale ter o seu criador de chatbots no seu servidor
Rodar o Typebot por conta própria deixa a instalação no seu servidor. Em troca, você cuida do SMTP, do HTTPS, das atualizações e do backup. Lembre da licença: a instância serve aos seus bots, não à revenda de acesso.
Quer conhecer a VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS
Perguntas frequentes
O Typebot é open source?
Não. O README o chama de fair source, e o código está sob a Functional Source License, que passa para a Apache 2.0 depois de dois anos de cada versão. Em caso de dúvida sobre uso comercial, consulte um profissional.
Posso oferecer Typebot hospedado para meus clientes?
Segundo a documentação, não. Ela proíbe vender acesso à sua instância e oferecer serviços de hospedagem de Typebot. Criar e publicar bots nos seus próprios produtos é permitido.
Preciso de SMTP para entrar?
Para o login por e-mail, sim: use um serviço de SMTP. Se escolher outro provedor de login, como Google ou GitHub, configure as variáveis dele.
Para que servem as portas 8080 e 8081?
A 8080 abre o builder, onde você monta os bots. A 8081 abre o viewer, onde o usuário final conversa com o bot.
Como atualizo o Typebot?
Puxe as imagens novas com docker compose pull, rode docker compose down e depois docker compose up -d, depois de copiar o banco e o .env.