Tutorial · Typebot · VPS

Como instalar o Typebot na VPS com EasyPanel e RustFS

Um passo a passo para configurar o Typebot com RustFS e acesso pelo GitHub, sem domínio próprio ou e-mail profissional.

Leonardo Amoyr
Leonardo Amoyr
Publicado em 18 de novembro de 2026 · leitura de 5 minutos
Conteúdo do artigo 10 seções

Se você tentou instalar o Typebot e teve problemas com o MinIO, neste tutorial eu mostro o método que usei para montar uma instalação própria com EasyPanel e RustFS. Também configurei o acesso pelo GitHub, sem precisar contratar um domínio próprio ou um e-mail profissional para essa instalação.

🎥 Assista ao passo a passo completo

O que você vai precisar

  • Uma VPS com recursos adequados à quantidade de acessos e serviços.
  • EasyPanel instalado no servidor.
  • Uma conta no GitHub para fazer login no Typebot.
  • Um computador com acesso à internet.
  • O material de apoio do tutorial, com as configurações mostradas no vídeo.

No vídeo, usei uma VPS da Hostinger. Você pode conferir os planos aqui e testar o cupom LEONARDO para 10% de desconto. Confira a elegibilidade, o valor total, o período contratado e o preço de renovação no carrinho: as condições podem mudar.

Como essa instalação funciona?

O Typebot cria chatbots e formulários conversacionais. A VPS é o servidor onde os serviços ficam instalados; o EasyPanel ajuda a gerenciá-los. O RustFS armazena os arquivos enviados aos fluxos usando uma API compatível com S3. Já o GitHub permite entrar no painel por autenticação OAuth.

Há dois componentes do Typebot: o Builder, onde você cria e administra os fluxos, e o Viewer, que mostra o chatbot para quem acessa o link. Você vai configurar ambos.

Se você acompanhou meu tutorial anterior de Typebot, vai perceber duas mudanças: agora uso GitHub para login e RustFS para armazenamento. No método anterior, mostrei uma configuração com e-mail SMTP.

1. Prepare a VPS e o EasyPanel

Na contratação, escolha a localização de servidor que faça sentido para o seu público e selecione o EasyPanel entre as aplicações disponíveis. No vídeo, usei uma KVM 2 porque também queria recursos para outros projetos. O tamanho ideal depende da carga, dos acessos simultâneos e dos outros serviços instalados.

Depois que a VPS estiver disponível, acesse o painel da Hostinger, abra o gerenciamento do EasyPanel e crie sua conta. Selecione um projeto novo: no vídeo, chamei o meu de bot.

2. Instale o Typebot pelo template

No projeto do EasyPanel, adicione um serviço pelo template do Typebot. Informe o endereço de e-mail que você usa na sua conta GitHub como administrador. Esse detalhe é importante para o login do exemplo.

Confira no material de apoio a versão e os valores necessários para acompanhar o vídeo. A versão exibida na gravação pode ter mudado; antes de atualizar, confira a compatibilidade e as notas oficiais. Aguarde os serviços iniciarem.

3. Configure o login com GitHub

Abra as configurações de domínio do Typebot Builder e copie o endereço gerado pelo EasyPanel. No GitHub, crie um aplicativo OAuth, usando esse endereço como página inicial e a URL de callback indicada no material de apoio.

O GitHub fornecerá um Client ID e permitirá gerar um Client Secret. Coloque os dois nos campos correspondentes do ambiente do Builder e salve. Não compartilhe o Client Secret: ele funciona como credencial da aplicação.

Você não precisa comprar um domínio próprio para repetir a demonstração: o vídeo usa os endereços fornecidos pelo painel. Isso não dispensa verificar HTTPS e a segurança dos acessos antes de colocar uma instalação em produção.

Ilustração do tutorial anterior de instalação do Typebot em uma VPS

4. Instale o RustFS

Adicione o RustFS pelo template do EasyPanel e siga a versão e as configurações do material de apoio. No vídeo, configuro dois endereços: um para o console, na porta 9001, e outro para a API S3, na porta 9000. Depois configuro o armazenamento persistente em /data e faço o deploy.

Atenção: a alteração de volumes mostrada no vídeo é feita em uma instalação nova. Não apague ou substitua volumes de uma instalação existente sem verificar o conteúdo e fazer backup: você pode perder arquivos.

Quando o serviço estiver disponível, entre no console do RustFS, crie o bucket typebot e configure a política de acesso e o CORS conforme o material de apoio. Uma política pública pode expor arquivos: revise as permissões e evite armazenar conteúdo sensível em um bucket acessível publicamente.

5. Conecte o Typebot ao armazenamento S3

No RustFS, crie uma chave de acesso para o Typebot e guarde a Access Key e a Secret Key em local seguro. No EasyPanel, adicione as variáveis S3 indicadas no material de apoio ao ambiente do Builder e do Viewer. Substitua os exemplos pelas credenciais geradas e pelo endereço da API S3 do seu RustFS.

Não coloque as credenciais do GitHub no Viewer. Salve as alterações e faça o deploy dos dois componentes. Confira se os deployments terminaram sem erro antes de continuar.

6. Teste o login, o upload e o chatbot

Abra o Builder e entre com o GitHub. Crie um fluxo simples com uma mensagem e uma imagem enviada do computador. Depois, teste e publique o chatbot, abra o link do Viewer e veja se o texto e a imagem aparecem.

Por fim, confira no console do RustFS se o arquivo está no bucket. Se alguma etapa falhar, revise os endereços, as credenciais, a política do bucket e os logs dos serviços. No vídeo, também mostro como reiniciar Builder e Viewer, mas isso não corrige necessariamente todos os problemas.

O Typebot self-hosted é ilimitado?

Instalar na própria VPS dá mais controle sobre a infraestrutura e evita depender dos limites de um plano hospedado específico. Isso não significa recursos infinitos: armazenamento, memória, processamento e acessos simultâneos dependem do servidor. A VPS tem custo, e você também fica responsável por backups, atualizações e segurança.

Para uso com clientes, confira a licença oficial do Typebot e as condições da versão que pretende usar. A licença atual distingue serviços profissionais prestados a usuários licenciados de usos comerciais concorrentes, que podem ser restringidos.

Próximo passo

Agora é acompanhar o vídeo e usar o material de apoio durante a instalação. Depois de testar, mantenha cópias de segurança do banco de dados e dos arquivos em local separado da VPS e teste a restauração.

Fontes: documentação do RustFS, repositório oficial do Typebot e vídeo do tutorial.