Base de Conhecimento

Typebot na VPS: como instalar seu criador de chatbots

  • typebot na vps, typebot, chatbot, docker, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Typebot na VPS: como instalar seu criador de chatbots

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_HOST e SMTP_PORT (a porta padrão é 25).
  • SMTP_USERNAME e SMTP_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_SECRET próprio e guardei uma cópia do .env fora da VPS.
  • Preenchi NEXTAUTH_URL e NEXT_PUBLIC_VIEWER_URL com 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.1 e 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.

Esta resposta lhe foi útil?

Artigos Relacionados