Como instalar o n8n no Ubuntu 24.04

O n8n (pronuncia-se “n-eight-n”) é uma plataforma de automação de fluxos de trabalho auto-hospedada, desenvolvida para oferecer flexibilidade e controle.
Ele permite automatizar praticamente qualquer processo — desde o envio de alertas e sincronização de dados até integrações complexas em nuvem — tudo de forma visual e personalizável.

Diferente de ferramentas SaaS, o n8n oferece controle total sobre seus dados e pode ser hospedado na infraestrutura de sua preferência, incluindo a LetsCloud.

Objetivos

Este guia tem como propósito ajudar você a:

1. Instalar e configurar o n8n manualmente em uma instância Ubuntu 24.04 limpa
2. Entender os componentes necessários (Docker, PostgreSQL e Nginx)
3. Gerenciar e proteger sua instância para uso em produção
4. Conhecer a imagem One-Click da LetsCloud, que automatiza todo o processo de instalação

Requisitos

Antes de iniciar, certifique-se de que seu ambiente atende aos seguintes requisitos:

Requisito	Descrição
Sistema Operacional	Ubuntu 24.04 LTS (instalação limpa recomendada)
Privilégios	Usuário com acesso sudo
Acesso à Internet	Necessário para baixar pacotes e containers
Armazenamento	Mínimo 20 GB SSD (recomendado 40 GB para fluxos e logs)
Memória (RAM)	Mínimo 2 GB, recomendado 4 GB ou mais para produção
CPU	Pelo menos 2 vCPUs
Domínio (opcional)	Para configuração HTTPS com Let’s Encrypt

Instalação Passo a Passo no Ubuntu 24.04

1. Atualizar o sistema

$
sudo apt update && sudo apt upgrade -y

2. Instalar Docker e Docker Compose

$$$
sudo apt install docker.io docker-compose -y
sudo systemctl enable docker
sudo systemctl start docker

3. Instalar PostgreSQL

$$$$
sudo apt install postgresql postgresql-contrib -y
sudo -u postgres psql -c "CREATE DATABASE n8n;"
sudo -u postgres psql -c "CREATE USER n8n_user WITH ENCRYPTED PASSWORD 'strongpassword';"
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE n8n TO n8n_user;"

4. Criar o arquivo Docker Compose do n8n

$$$
sudo mkdir -p /opt/n8n
cd /opt/n8n
sudo nano docker-compose.yml

Cole o conteúdo abaixo:

version: "3"
services:
  n8n:
    image: n8nio/n8n:latest
    ports:
      - "5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=localhost
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n_user
      - DB_POSTGRESDB_PASSWORD=strongpassword
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=yourpassword
      - N8N_HOST=your-domain.com
      - N8N_PORT=5678
    restart: always

Salve e inicie o container:

$
sudo docker-compose up -d

5. Instalar e configurar o Nginx

$$
sudo apt install nginx -y
sudo nano /etc/nginx/conf.d/n8n.conf

Adicione o conteúdo:

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Reinicie o Nginx:

$
sudo systemctl restart nginx

6. Habilitar HTTPS com Let’s Encrypt (opcional)

$$
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

7. Configurar o firewall

$$$$
sudo ufw allow ssh
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

8. Acessar o n8n

Abra o navegador e acesse:

http://seu-endereco-ip/

Conclua o assistente inicial e comece a criar seus fluxos de automação.

Solução de Problemas

Se o n8n não iniciar:

$$
sudo docker ps
sudo docker logs n8n-n8n-1

Verifique o PostgreSQL:

$
sudo systemctl status postgresql

Verifique o Nginx:

$$
sudo nginx -t
sudo tail -f /var/log/nginx/error.log

Backup e Restauração

Realizar backup:

$
sudo -u postgres pg_dump n8n > n8n_backup.sql

Restaurar backup:

$
sudo -u postgres psql -d n8n < n8n_backup.sql

Implantação com One-Click na LetsCloud

Se preferir pular a instalação manual, a LetsCloud oferece uma imagem pronta para uso do n8n, criada com Packer e otimizada para produção.

Principais Recursos

• n8n, PostgreSQL, Nginx e Docker já instalados
• Inicialização automática via systemd
• Pronto para configuração SSL/TLS
• Segurança reforçada (sem credenciais padrão)

Como Implantar

1. Acesse o Painel da LetsCloud
2. Clique em Create Server
3. Escolha a imagem n8n-24-04
4. Selecione a região e o plano desejado
5. Clique em Deploy e comece a automatizar em poucos minutos

Inicie agora na LetsCloud →

Conclusão

Seja pela instalação manual ou pela implantação One-Click, o n8n oferece a flexibilidade e o controle necessários para criar automações poderosas e seguras.
Com a LetsCloud, você pode ter seu ambiente de automação em funcionamento em menos de cinco minutos.