Como instalar n8n e hospedá-lo no seu VPS com Ubuntu

O n8n é uma ferramenta de automação de fluxos de trabalho que permite a integração sem complicações entre diversos aplicativos e APIs. A possibilidade de hospedá-lo por conta própria em um VPS Ubuntu oferece mais privacidade aos seus dados, mais opções de personalização e economia de custos, especialmente em comparação com soluções gerenciadas.

Neste guia, explicaremos dois métodos de instalação do n8n em um VPS Ubuntu: o método em um clique, oferecido pela Hostinger, e uma instalação manual para usuários que preferem ter mais controle. Ao final da leitura, você terá uma instância do n8n totalmente funcional rodando no seu VPS, pronta para automatizar seus fluxos de trabalho.

Pré-requisitos

Antes de instalar o n8n, certifique-se de que seu ambiente de hospedagem atenda aos seguintes requisitos:

• Servidor virtual privado (VPS) Ubuntu

Mínimo: 1 vCPU, 1 GB de RAM (KVM1)

Recomendado: 2 vCPU, 2 GB de RAM (KVM2)
Se você ainda não tem um VPS, a Hostinger oferece uma variedade de opções de VPS, incluindo a hospedagem VPS n8n. 

• Domínio/subdomínio: Opcional, mas recomendado para configurar o HTTPS e facilitar o acesso.
• Acesso ao seu VPS: você precisará se conectar ao seu VPS por SSH (é necessário ter acesso root) ou usando um painel de controle de hospedagem (como o hPanel).
• Docker: se você optar pela instalação manual, verifique se o Docker está instalado em seu VPS (ele não é necessário caso você opte pelo template).

Como instalar n8n usando o template de VPS da Hostinger

Vamos começar com o método mais fácil: usar o template n8n de um clique da Hostinger. Esse método torna a configuração do servidor Ubuntu totalmente automática e instala o n8n e suas dependências sem que você precise mexer em uma linha de código sequer. Vamos aos passos!

1. Acesse o painel de controle do VPS

Primeiro, você precisa acessar o painel de controle do seu VPS.

1. Acesse o hPanel e faça login usando seu método escolhido.
2. Após logar, navegue até a seção VPS no menu do lado direito.
3. Escolha o VPS ao qual você deseja aplicar o template n8n e clique no botão Gerenciar ao lado dele.

2. Instale o template n8n

1. No painel de controle do VPS, abra o menu suspenso SO e Painel à esquerda e selecione Sistema operacional.

É aqui que você pode encontrar os sistemas operacionais e os templates disponíveis para o seu servidor VPS.

2. No painel Mudar SO, digite n8n na barra de pesquisa e selecione o template n8n.
3. Na janela de diálogo que se abrirá, clique ou toque em Alterar sistema operacional
4. Você verá uma janela de diálogo informando que o sistema operacional do VPS será sobrescrito e que todos os arquivos serão excluídos. Marque a caixa de seleção ao lado de “Reconheço que todos os meus arquivos serão excluídos e não poderão ser restaurados” e clique em Próximo.
5. Digite uma senha para o usuário root e clique em Confirmar.

A configuração do template será iniciada. Você verá uma barra de progresso na parte superior do painel, como no exemplo abaixo:

Após uma breve espera, sua instância do n8n estará pronta para uso.

3. Teste a instalação

Com o n8n configurado no seu VPS, você poderá fazer login e confirmar que ele está funcionando.

1. Na página Visão geral do VPS, clique em Gerenciar aplicativo.

2. Isso abrirá a janela de diálogo do n8n para registro, que deve ser parecida com o exemplo abaixo:

3. Basta inserir seus dados e criar uma senha de acordo com as especificações indicadas. Pressione o botão Next e clique em todos os pop-ups adicionais, deixando-os vazios por enquanto. Em seguida, você verá a página de visão geral do n8n:

4. Se você estiver vendo o painel do n8n em sua visualização padrão como esta, sua configuração foi bem-sucedida!

4. Configure sua instância n8n

Agora que sua instância do n8n está em funcionamento, vamos ajustar suas configurações de segurança e personalização.

1. Clique ou toque no ícone de três pontos ao lado de seu nome no canto inferior esquerdo e selecione Settings:

2. Selecione Personal no menu do lado esquerdo:

É aqui que você pode ver e ajustar todas as suas credenciais, como Nome, Sobrenome, E-mail e Senha.

Você também pode modificar o n8n com variáveis de ambiente:

1. Conecte-se ao seu VPS via SSH ou pelo Terminal do navegador.
2. Abra o arquivo docker compose.yml com o nano:

nano ../root/docker compose.yml

3. Edite a seção Environment, onde você pode adicionar ou ajustar as variáveis de ambiente. Por exemplo, se você quiser ativar a autenticação básica, adicione:

  - N8N_BASIC_AUTH_ACTIVE=true
  - N8N_BASIC_AUTH_USER=username
  - N8N_BASIC_AUTH_PASSWORD="password"

Substitua username e password no exemplo acima pelo nome de usuário e senha reais do seu usuário.

Aqui estão algumas outras variáveis de ambiente que talvez você queira incluir ou ajustar:

• N8N_HOST – defina isso com seu domínio, se estiver usando um.
• N8N_PORT – a porta padrão é 5678, mas você pode alterá-la, se necessário.
• N8N_PROTOCOL – especifica qual protocolo o n8n deve usar.
• WEBHOOK_URL – obrigatório se você estiver usando webhooks com um domínio.
• GENERIC_TIMEZONE – fuso horário opcional.

4. Salve e feche o nano digitando CTRL + X, depois Y e ENTER. Para confirmar que suas alterações foram salvas, execute:

cat docker compose.yml

Isso retornará o arquivo completo do Docker Compose. Você deverá ver suas alterações lá.

5. Reinicie o Docker Compose para aplicar as alterações:

docker compose down
docker compose up -d

Depois de reiniciar o Docker Compose, suas alterações serão implementadas. O n8n usará as variáveis de ambiente que você definiu.

Se estiver usando um domínio personalizado, você também deve configurar o SSL. Para obter uma conexão HTTPS segura, você pode usar o Let’s Encrypt com o NGINX como proxy reverso:

1. Instale o Certbot e o NGINX:

sudo apt install certbot nginx python3-certbot-nginx -y

2. Crie/abra o arquivo do site NGINX para o n8n:

sudo nano /etc/nginx/sites-available/n8n

3. Configure o NGINX como um proxy para o tráfego para o n8n. Adicione o seguinte, substituindo yourdomain.com abaixo por seu domínio próprio:

server {
server_name yourdomain.com;
location / {
    proxy_pass http://localhost:5678;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}
}

Salve e feche o arquivo com CTRL + X, depois Y e ENTER.

4. Habilite a configuração e reinicie o NGINX:

sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo systemctl restart nginx

5. Obtenha um certificado SSL para seu domínio personalizado (substitua yourdomain.com abaixo por seu nome de domínio personalizado):

sudo certbot --nginx -d yourdomain.com

6. Abra o crontab:

sudo certbot renew

Selecione nano se for solicitado a selecionar o editor.

7. Adicione o seguinte cron job:

0 2 * * * certbot renew --quiet --post-hook "systemctl restart nginx"

Os certificados Let’s Encrypt expiram a cada 90 dias por padrão. Com esse cron job ativo, o certbot renovará seu certificado automaticamente quando necessário.

8. Abra o arquivo docker compose.yml com o nano:

nano ../root/docker compose.yml

9. Atualize as seguintes variáveis de ambiente:

  - WEBHOOK_URL=https://yourdomain.com/
- N8N_HOST=yourdomain.com
  - N8N_PORT=5678
  - N8N_PROTOCOL=https

Salve e feche o arquivo com CTRL + X, depois Y e ENTER.

10.  Reinicie o Docker Compose para executar as alterações.

docker compose down
docker compose up -d

Feito isso, sua instância n8n pode ser acessada com segurança usando seu domínio personalizado (por exemplo, https://yourdomain.com).

Como instalar o n8n no Ubuntu manualmente

Se estiver usando um provedor de hospedagem VPS sem um template para instalação do n8n com um clique, você terá que instalar a ferramenta manualmente. Vamos explicar o processo passo a passo.

1. Instale as dependências

Antes de configurar o n8n manualmente, precisamos instalar algumas dependências essenciais. Comece conectando-se ao seu VPS por meio de SSH ou de um console na web. Em seguida, atualize suas listas de pacotes e atualize os pacotes existentes para suas versões mais recentes executando:

sudo apt-get update && sudo apt-get upgrade -y

Isso garante que seu sistema terá os patches de segurança e as versões de software mais recentes antes de prosseguir.

Você tem dois métodos principais para executar o n8n auto-hospedado:

• Instalação direta
• Instalação em contêineres

A instalação em contêineres é mais indicada na maioria dos cenários, mas descreveremos brevemente ambos.

Instalação direta

O n8n pode ser executado diretamente em um ambiente Node.js, portanto, se você não estiver usando o Docker, instale a versão mais recente de suporte de longo prazo (LTS) do Node.js:

1. Instale o curl e o script de configuração do Node.js:

 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

2. Instale o Node.js e o npm:

sudo apt-get install -y nodejs

3. Verifique as instalações:

node -v
npm -v

Esses comandos retornarão versões do npm e do Node.js, se eles estiverem instalados.

Instalação em contêineres

Se preferir executar o n8n em um contêiner do Docker, instale o Docker primeiro.

1. Instale as dependências necessárias:

 sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common

2. Adicione a chave GPG oficial do Docker:

 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

3. Adicione o repositório do Docker e instale o Docker:

 echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io

4. Verifique se o Docker está instalado:

docker --version

Esse comando retornará a versão do Docker se ele estiver instalado.

2. Configure o n8n

Depois de ter todas as dependências instaladas, você pode configurar o n8n.

Instalação direta

Se você instalou o Node.js no passo anterior, poderá instalar o n8n globalmente usando o npm:

npm install -g n8n

Inicie uma sessão screen chamada n8n:

screen -S n8n

Execute o n8n dentro da sessão screen:

n8n

Para se desconectar da sessão screen, digite CTRL+ A e depois D. Se quiser se reconectar para interagir com o n8n, execute:

screen -R n8n

Por padrão, o n8n é executado na porta 5678. Agora você pode acessá-lo em:

http://ip-do-servidor:5678

Você pode receber um erro de cookie seguro neste ponto. Vamos abordar a criação do certificado SSL nas próximas etapas.

Instalação em contêineres

Extraia a imagem mais recente do Docker n8n:

docker pull n8nio/n8n

Execute o contêiner com mapeamento de porta:

docker run -d --name n8n -p 5678:5678 n8nio/n8n

• -d – Executa o contêiner em segundo plano.
• -name n8n – Nomeia o contêiner como n8n.
• -p 5678:5678 – Mapeia a porta 5678 no servidor para a porta 5678 no contêiner.

Para acessar o n8n em seu navegador, abra:

http://ip-do-servidor:5678

Assim como nas etapas de instalação acima, você poderá encontrar um erro de cookie seguro. Consulte a seção de criação de certificado SSL abaixo para resolvê-lo.

Por padrão, os dados dentro de um contêiner Docker não são persistentes. Para garantir que seus fluxos de trabalho e configurações sejam salvos, execute o n8n com um volume montado:

 docker stop n8n && docker rm n8n #stop and remove previous n8n container
docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

Isso mapeia sua pasta local ~/.n8n para o diretório de dados do n8n dentro do contêiner.

Se o contêiner não for iniciado, talvez faltem permissões para fazer gravações no volume. Ative as permissões executando:

sudo chown -R 1000:1000 ~/.n8n
sudo chmod -R 755 ~/.n8n

Em seguida, inicie o contêiner:

docker start n8n

3. Configure o n8n

Por padrão, o n8n não exige autenticação, portanto, qualquer pessoa que acesse o IP do seu servidor pode usá-lo. Para proteger sua instância, defina variáveis de ambiente antes de executar o contêiner.

Com a instalação direta, você pode usar o comando export para adicionar variáveis. No exemplo abaixo, certifique-se de substituir username, password e yourdomain.com pelas credenciais escolhidas:

export N8N_BASIC_AUTH_ACTIVE=true
export N8N_BASIC_AUTH_USER=username
export N8N_BASIC_AUTH_PASSWORD=password
export N8N_HOST=yourdomain.com
export N8N_PORT=5678
export WEBHOOK_URL=https://yourdomain.com/
export GENERIC_TIMEZONE=UTC

Ao executar o n8n como um contêiner do Docker (instalação em contêiner), você pode passar essas variáveis usando o sinalizador -e (novamente, adicione suas próprias credenciais abaixo):

 docker stop n8n && docker rm n8n #stop and remove previous n8n container
docker run -d --name n8n \
  -p 5678:5678 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=username \
  -e N8N_BASIC_AUTH_PASSWORD=password \
  -e N8N_HOST=yourdomain.com \
  -e N8N_PORT=5678 \
  -e WEBHOOK_URL=https://yourdomain.com/ \
  -e GENERIC_TIMEZONE=UTC \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

4. Habilite o acesso seguro

Para proteger sua instância do n8n e garantir conexões criptografadas, configuraremos o SSL (HTTPS) usando o Let’s Encrypt e o NGINX como proxy reverso. Isso é especialmente importante se você estiver usando um domínio personalizado.

5. Instale o NGINX e o Certbot:

 sudo apt update && sudo apt install nginx certbot python3-certbot-nginx -y

6. Habilite e inicie o NGINX:

sudo systemctl enable nginx
sudo systemctl start nginx

7. Crie e abra um novo arquivo de configuração do NGINX para o n8n:

sudo nano /etc/nginx/sites-available/n8n

8. Adicione a seguinte configuração, substituindo yourdomain.com pelo seu domínio real:

server {
    server_name yourdomain.com;
    location / {
        proxy_pass http://localhost:5678;  # Forward requests to n8n
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    listen 80;
}

Em seguida, salve e saia digitando CTRL + X, Y e ENTER.

9. Habilite a configuração:

 sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/

10.  Reinicie o NGINX:

sudo systemctl restart nginx

11. Gere um certificado SSL gratuito da Let’s Encrypt:

sudo certbot --nginx -d yourdomain.com

12. Abra o crontab:

sudo certbot renew

Selecione nano se for solicitado a selecionar o editor.

13. Adicione o seguinte cron job:

 0 2 * * * certbot renew --quiet --post-hook "systemctl restart nginx"

Os certificados Let’s Encrypt expiram a cada 90 dias por padrão. Com esse cron job ativo, o Certbot renovará seu certificado automaticamente.

Para confirmar que o n8n está sendo executado com HTTPS, abra seu navegador e digite seu nome de domínio no formato https://seudominio.com. Se você vir a interface do n8n sem nenhum aviso de SSL, sua configuração foi bem-sucedida e o n8n está pronto para ser usado!

Conclusão

Parabéns! Você instalou o n8n com sucesso e ele está devidamente hospedado em seu próprio servidor. Não importa se você usou a configuração de um clique da Hostinger ou instalou o n8n manualmente — agora você tem uma poderosa ferramenta de automação de fluxos de trabalho na ponta dos dedos.

Agora é hora de começar a criar workflows e automatizar tarefas! De simples integrações n8n a processos complexos, a plataforma te dá a flexibilidade de conectar aplicativos, APIs e bancos de dados sem escrever um monte de código.

Lembre-se destes pontos-chave:

• Mantenha o n8n seguro: Use autenticação, ative HTTPS e restrinja o acesso quando necessário.
• Atualize regularmente: Mantenha a plataforma atualizada com os recursos e correções de segurança mais recentes atualizando sua instalação periodicamente.
• Faça backup de seus dados: Se estiver usando o Docker, garanta o armazenamento persistente para que seus fluxos de trabalho e credenciais estejam seguros.

Se você tiver algum problema ou quiser explorar configurações avançadas, consulte a documentação do n8n ou participe da comunidade n8n para obter suporte. Boa sorte!

Como instalar n8n: perguntas frequentes