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.
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.

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.
- Assistir ao tutorial completo
- Abrir o material de apoio
- Conhecer os planos de VPS da Hostinger e testar o cupom LEONARDO.
- Leia também: Como instalar o OpenBot na VPS.
Fontes: documentação do RustFS, repositório oficial do Typebot e vídeo do tutorial.