Recurso Como Instalar e Personalizar o Typebot: Usando Múltiplas Versões de Node.js com NVM, PNPM e PM2 v2.26.1 <-> 8c41d58

Neste tutorial, vamos explorar como instalar e configurar o Typebot em seu servidor, usando NVM para gerenciar múltiplas versões do Node.js, PNPM como gerenciador de pacotes, e PM2 para gerenciar os processos de execução. Mesmo que o Typebot atualmente exija o Node.js v18, é altamente recomendado configurar seu ambiente para suportar várias versões do Node, o que permitirá que você desenvolva projetos futuros sem a necessidade de reinstalações.

---

Requisitos Mínimos para Instalação do Typebot​

• Sistema Operacional:
  • Ubuntu 22.04 LTS
• Processador:
  • 2 núcleos ou mais (recomendado para ambientes de produção)
• Memória RAM:
  • Mínimo de 4 GB (recomendado 8 GB para melhor desempenho)
• Espaço em Disco:
  • Pelo menos 20 GB de espaço disponível
• Node.js:
  • NVM para gerenciamento de versões de Node.js
  • Node.js versão 18 para o Typebot
• Gerenciamento de Processos:
  • PM2 para controlar e monitorar os processos do Typebot
• Banco de Dados:
  • PostgreSQL (versão 13 ou superior)
• Dependências de Sistema:
  • Git (para clonar o repositório)
  • PNPM (gerenciador de pacotes leve e rápido)

Clique para expandir...

Passos para Atualizar o Sistema Antes da Instalação

Clique para expandir...

Antes de iniciar a instalação, é importante garantir que o sistema esteja atualizado e com todas as dependências necessárias instaladas. Execute os seguintes comandos:

Código:

# Atualizar os pacotes do sistema
sudo apt update && sudo apt upgrade -y

# Instalar Git e PostgreSQL
sudo apt install git postgresql postgresql-contrib -y

# Instalar Curl (necessário para instalar o NVM)
sudo apt install curl -y

Com isso, seu ambiente estará pronto para começar a instalação do Typebot.

Clique para expandir...

Por Que Usar Múltiplas Versões do Node.js?​

O Typebot requer Node.js v18, mas instalar e gerenciar várias versões do Node.js tem suas vantagens:

1. Compatibilidade de Projetos: Diferentes projetos podem exigir versões específicas do Node.js. Manter múltiplas versões instaladas evita conflitos entre dependências.
2. Futuras Atualizações: Mesmo que o Typebot utilize Node.js v18 hoje, versões mais novas como a v20 ou v22 podem ser necessárias em projetos futuros.
3. Facilidade de Manutenção: Usar uma ferramenta como o NVM (Node Version Manager) torna muito mais fácil alternar entre diferentes versões do Node.js. Isso é especialmente útil quando você precisa testar ou depurar aplicativos em diferentes ambientes.

Agora que você entende os benefícios, vamos passar para a instalação.

---

Passo 1: Instalar o NVM​

O NVM é uma ferramenta de linha de comando que permite instalar e alternar entre diferentes versões do Node.js. Para instalá-lo, execute o comando a seguir:


Verifique se a instalação foi bem-sucedida:

---

Passo 2: Instalar Várias Versões do Node.js​

Com o NVM instalado, você pode agora instalar as versões do Node.js necessárias. Vamos instalar a versão 18 (obrigatória para o Typebot) e algumas versões mais recentes para possíveis projetos futuros:


Defina a versão 18 como padrão para o Typebot:

Confirme que a versão 18 está em uso:

---

Passo 3: Instalando o PNPM​

O PNPM é uma alternativa mais eficiente ao NPM, consumindo menos espaço e melhorando a performance na instalação de pacotes. Para instalar o PNPM globalmente, execute:


Verifique a instalação:

Passo 4: Gerenciar Processos com PM2​

O PM2 é um gerenciador de processos que facilita o gerenciamento de aplicativos Node.js em produção. Usaremos o PM2 para gerenciar os processos do Typebot.

Instale o PM2 globalmente:

Verifique a versão instalada:

Antes de iniciar o Typebot, verifique se não há processos anteriores do Typebot em execução. Para parar e deletar processos antigos, execute:

Passo 5: Clonando o Repositório do Typebot​

Agora, vamos clonar o repositório oficial do Typebot no GitHub:


Para garantir que estamos utilizando a versão correta (neste caso, v2.26.1), execute:

Passo 6: Configurar o Arquivo .env​

O Typebot precisa de um arquivo .env para armazenar suas variáveis de ambiente. Copie o arquivo de exemplo e edite conforme suas necessidades:


No arquivo .env, insira as chaves de API, URLs e informações de banco de dados conforme as instruções da documentação oficial. Consulte a documentação do Typebot para detalhes sobre as variáveis necessárias: Documentação Oficial Typebot.

Instalação e Personalização do Typebot: Como Usar Múltiplas Versões do Node.js com NVM, PNPM e PM2​

Neste tutorial, vamos explorar como instalar e configurar o Typebot em seu ambiente local, usando NVM para gerenciar múltiplas versões do Node.js, PNPM como gerenciador de pacotes, e PM2 para gerenciar os processos de execução. Mesmo que o Typebot atualmente exija o Node.js v18, é altamente recomendado configurar seu ambiente para suportar várias versões do Node, o que permitirá que você desenvolva projetos futuros sem a necessidade de reinstalações.

---

Por Que Usar Múltiplas Versões do Node.js?​

O Typebot requer Node.js v18, mas instalar e gerenciar várias versões do Node.js tem suas vantagens:

1. Compatibilidade de Projetos: Diferentes projetos podem exigir versões específicas do Node.js. Manter múltiplas versões instaladas evita conflitos entre dependências.
2. Futuras Atualizações: Mesmo que o Typebot utilize Node.js v18 hoje, versões mais novas como a v20 ou v22 podem ser necessárias em projetos futuros.
3. Facilidade de Manutenção: Usar uma ferramenta como o NVM (Node Version Manager) torna muito mais fácil alternar entre diferentes versões do Node.js. Isso é especialmente útil quando você precisa testar ou depurar aplicativos em diferentes ambientes.

Agora que você entende os benefícios, vamos passar para a instalação.

---

Passo 1: Instalar o NVM​

O NVM é uma ferramenta de linha de comando que permite instalar e alternar entre diferentes versões do Node.js. Para instalá-lo, execute o comando a seguir:
bash

Verifique se a instalação foi bem-sucedida:

---

Passo 2: Instalar Várias Versões do Node.js​

Com o NVM instalado, você pode agora instalar as versões do Node.js necessárias. Vamos instalar a versão 18 (obrigatória para o Typebot) e algumas versões mais recentes para possíveis projetos futuros:
Defina a versão 18 como padrão para o Typebot:
Confirme que a versão 18 está em uso:

---

Passo 3: Instalando o PNPM​

O PNPM é uma alternativa mais eficiente ao NPM, consumindo menos espaço e melhorando a performance na instalação de pacotes. Para instalar o PNPM globalmente, execute:
Verifique a instalação:

---

Passo 4: Gerenciar Processos com PM2​

O PM2 é um gerenciador de processos que facilita o gerenciamento de aplicativos Node.js em produção. Usaremos o PM2 para gerenciar os processos do Typebot.
Instale o PM2 globalmente:
Verifique a versão instalada:
Antes de iniciar o Typebot, verifique se não há processos anteriores do Typebot em execução. Para parar e deletar processos antigos, execute:

---

Passo 5: Clonando o Repositório do Typebot​

Agora, vamos clonar o repositório oficial do Typebot no GitHub:
Para garantir que estamos utilizando a versão correta (neste caso, v2.26.1), execute:
bash

---

Passo 6: Configurar o Arquivo .env​

O Typebot precisa de um arquivo .env para armazenar suas variáveis de ambiente. Copie o arquivo de exemplo e edite conforme suas necessidades:
No arquivo .env, insira as chaves de API, URLs e informações de banco de dados conforme as instruções da documentação oficial. Consulte a documentação do Typebot para detalhes sobre as variáveis necessárias: Documentação Oficial Typebot.

---

Passo 7: Instalando Dependências e Compilando o Typebot​

Use o PNPM para instalar todas as dependências necessárias para o Typebot:


Caso você enfrente problemas de memória durante a compilação, ajuste o tamanho da memória alocada:

Agora compile os aplicativos do Typebot:

---

Passo 8: Iniciar o Typebot​

Depois que a compilação for concluída, vamos iniciar o servidor do builder (construtor) e o viewer (visualizador).

Para iniciar o builder na porta 3001:
Para iniciar o viewer na porta 3002:

Para garantir que esses processos rodem continuamente, podemos gerenciá-los com o PM2:

Passo 9: Configurar o PostgreSQL​

Se ainda não configurou o banco de dados PostgreSQL, siga estas etapas:

1. Acesse o PostgreSQL:

2. Crie um novo usuário e banco de dados:
3. Conceda permissões ao usuário:

---

Passo 10: Personalizações Adicionais​

1. Alterar Logomarca e Favicon​

Para personalizar o favicon do Typebot, substitua a imagem no seguinte diretório:

2. Traduzir E-mails​

Edite o arquivo de e-mails para personalizar o conteúdo enviado aos usuários:

---

Passo 11: Configurar PM2 para Produção​

Para garantir que o Typebot reinicie automaticamente após uma reinicialização do servidor, configure o PM2:

Passo 12: Limpeza de Cache​

Mantenha seu ambiente limpo, removendo cache de pacotes desnecessários:

Conclusão​

Seguindo este passo a passo, você configurou corretamente o Typebot com suporte a múltiplas versões do Node.js, utilizando NVM, PNPM e PM2. A flexibilidade de alternar entre diferentes versões do Node.js ajudará em futuros projetos e garantirá que seu ambiente de desenvolvimento esteja preparado para futuras atualizações.

Se precisar de mais informações ou assistência, consulte a documentação oficial ou participe da comunidade.