Como hospedar o n8n em um VPS Linux (passo a passo)

Introdução

O n8n é uma das ferramentas de automação de fluxos de trabalho de código aberto mais poderosas disponíveis atualmente. Ao contrário de alternativas SaaS, como o Zapier ou o Make, o n8n oferece controle total sobre seus dados e automações — mas somente quando você mesmo o hospeda. Um VPS Linux é o ambiente ideal para isso: sempre ativo, acessível e totalmente sob seu controle.

Este guia orienta você por todo o processo de configuração de uma instância do n8n pronta para produção e auto-hospedada em um VPS Linux. Você passará de um servidor vazio para uma implantação do n8n totalmente segura e habilitada para SSL, com Docker, Nginx, PostgreSQL, backups automatizados e uma configuração de segurança reforçada.

Pontos-chave

• O n8n em um VPS oferece fluxos de trabalho ilimitados, sem limites de uso e propriedade total dos dados
• O Docker é o método de instalação recomendado para facilitar atualizações e isolamento
• O PostgreSQL é o banco de dados recomendado para cargas de trabalho em produção (não o SQLite)
• É necessário um proxy reverso (Nginx) com SSL do Let’s Encrypt para uso em produção
• Seu VPS deve ter pelo menos 1 vCPU e 2 GB de RAM para uma experiência tranquila com o n8n e o PostgreSQL
• Backups automáticos regulares protegem os dados do seu fluxo de trabalho e suas credenciais

O que é o n8n?

O n8n (pronuncia-se “n-oito-n”) é uma plataforma de automação de fluxos de trabalho com código-fonte aberto que permite conectar aplicativos, APIs e serviços usando um editor visual baseado em nós. Ele oferece suporte a mais de 400 integrações prontas para uso e permite executar código personalizado em JavaScript ou Python dentro dos fluxos de trabalho.

A principal diferença entre o n8n e seus concorrentes resume-se a três aspectos: propriedade, custo e flexibilidade.

**Propriedade: **Quando você hospeda o n8n por conta própria, seus dados de fluxo de trabalho, credenciais e logs de execução nunca saem do seu servidor. Para equipes que lidam com dados confidenciais de clientes, registros financeiros ou lógica de negócios proprietária, isso é extremamente importante. As plataformas em nuvem armazenam sua lógica de automação em sua infraestrutura, sujeita às políticas de retenção de dados e à postura de segurança delas.

**Custo: **O plano de nuvem do n8n cobra por execução de fluxo de trabalho, o que aumenta rapidamente em automações de alto volume. Uma equipe de médio porte que executa milhares de tarefas por dia pode gastar centenas de dólares por mês. Em seu próprio VPS, depois de pagar pelo servidor, as execuções são ilimitadas, sem custo adicional.

**Flexibilidade: **O n8n auto-hospedado permite que você instale nós da comunidade, execute código arbitrário dentro de fluxos de trabalho, conecte-se a serviços internos não acessíveis pela internet pública e configure todos os aspectos da implantação do jeito que quiser. Os planos na nuvem restringem muitos desses recursos.

Pré-requisitos

Antes de começar, certifique-se de ter:

• Um VPS Linux rodando Ubuntu 22.04 ou 24.04 (recomendado). Verifique se o seu provedor oferece o Ubuntu no plano que você escolher, pois alguns planos básicos oferecem apenas outras distribuições
• Um usuário não root com privilégios de sudo
• Um nome de domínio apontado para o endereço IP do seu VPS (por exemplo, n8n.seudominio.com)
• Acesso SSH ao seu servidor
• Conhecimento básico da linha de comando do Linux

Escolhendo o VPS certo

O servidor que você escolher tem impacto direto no desempenho do n8n. No mínimo, você precisa de 1 vCPU, 2 GB de RAM e 20 GB de armazenamento em SSD. A RAM extra, em comparação com uma instalação mínima baseada em SQLite, é necessária porque o PostgreSQL, o Nginx e o n8n são executados simultaneamente.

Para equipes com vários usuários, fluxos de trabalho complexos com várias etapas ou alto volume de webhooks, atualize para 2 vCPU e 4 GB de RAM. O armazenamento deve ter, no mínimo, 40 GB se você planeja manter logs de execução longos.

A PetroSky oferece planos de VPS NVMe em Paris e Montreal, com o n8n disponível como um aplicativo de um clique no momento da finalização da compra: um script de instalação de código aberto implanta o n8n com o Docker Compose e configura o HTTPS automaticamente por meio do Caddy e do Let’s Encrypt. Este guia aborda a rota manual, que funciona com qualquer provedor.

Ao selecionar um provedor de VPS, leve também em consideração a localização geográfica. Hospede sua instância do n8n na região mais próxima dos serviços aos quais ela se conectará com mais frequência — isso reduz a latência da API nas execuções do seu fluxo de trabalho.

Passo 1: Atualize seu servidor

Conecte-se via SSH ao seu VPS e execute uma atualização completa do sistema antes de instalar qualquer coisa:

    sudo apt update && sudo apt upgrade -y

Isso garante que você tenha os patches de segurança mais recentes e que todas as bibliotecas do sistema estejam atualizadas antes de instalar o Docker e outros softwares.

Reinicie o sistema se uma atualização do kernel tiver sido aplicada:

    sudo reboot

Depois de se reconectar via SSH, crie um usuário dedicado no sistema para executar o n8n. Executar serviços como root representa um risco à segurança:

    sudo adduser n8nuser
    sudo usermod -aG sudo n8nuser
    su - n8nuser

Etapa 2: Instalar o Docker e o Docker Compose

O método de instalação oficial recomendado pelo n8n é o Docker. O Docker isola o n8n e suas dependências do restante do sistema, facilitando atualizações e reversões.

Instale o Docker usando o script oficial de conveniência:

    curl -fsSL https://get.docker.com | sudo sh

A documentação do Docker observa que o script de conveniência não é recomendado para ambientes de produção, pois instala a versão mais recente sem permitir que você escolha uma versão específica. Se você quiser fixar versões do Docker, use o método do repositório apt, conforme descrito no guia de instalação do Docker para Ubuntu (docs.docker.com/engine/install/ubuntu/).

Adicione seu usuário ao grupo Docker para que você possa executar comandos do Docker sem o `sudo`:

    sudo usermod -aG docker $USER
    newgrp docker

Verifique se o Docker está funcionando corretamente:

    docker --version
    docker compose version

Ambos os comandos devem retornar as strings de versão sem erros. Se o Docker Compose não for encontrado, instale-o manualmente:

    sudo apt install docker-compose-plugin -y

Etapa 3: Configurar o PostgreSQL para produção

Por padrão, o n8n usa o SQLite como banco de dados. O SQLite é adequado para uso pessoal e fluxos de trabalho leves, mas lida mal com gravações simultâneas, o que se traduz em lentidão e erros do tipo “banco de dados bloqueado” quando muitos fluxos de trabalho são executados ao mesmo tempo. Para uma implantação em produção, o PostgreSQL é a escolha certa.

Execute o PostgreSQL dentro do Docker junto com o n8n:

    mkdir ~/n8n && cd ~/n8n

Crie um arquivo de ambiente para armazenar seus segredos com segurança. Nunca codifique senhas diretamente no seu arquivo `compose`:

    nano ~/n8n/.env

Adicione o seguinte, substituindo os valores de preenchimento por senhas fortes e exclusivas:

    POSTGRES_USER=n8n
    POSTGRES_PASSWORD=sua_senha_forte_para_o_banco_de_dados_aqui
    POSTGRES_DB=n8n
    N8N_ENCRYPTION_KEY=sua_sequência_aleatória_de_32_caracteres_aqui

Gere uma chave de criptografia segura com:

    openssl rand -hex 16

Use o resultado como sua N8N_ENCRYPTION_KEY. Essa chave criptografa as credenciais armazenadas no n8n — se você a perder, todas as credenciais salvas se tornarão irrecuperáveis.

Etapa 4: Crie o arquivo Docker Compose do n8n

Crie o arquivo docker-compose.yml no diretório do n8n:

    nano ~/n8n/docker-compose.yml

Cole a seguinte configuração:

services:
  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 10


  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=produção
      - WEBHOOK_URL=https://n8n.yourdomain.com/
      - GENERIC_TIMEZONE=Europe/London
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - EXECUTIONS_MODE=regular
      - N8N_LOG_LEVEL=info
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy


volumes:
  postgres_data:
  n8n_data:

Notas de configuração:

• A vinculação da porta 127.0.0.1:5678:5678 garante que o n8n seja acessível apenas localmente. O Nginx lidará com todo o tráfego externo — nunca exponha a porta 5678 diretamente à internet.
• O `depends_on` com a condição `service_healthy` garante que o n8n aguarde até que o PostgreSQL esteja totalmente pronto antes de iniciar. Sem isso, o n8n falhará na primeira inicialização se o banco de dados ainda não estiver aceitando conexões.
• N8N_LOG_LEVEL=info fornece logs operacionais úteis sem sobrecarregar o armazenamento em disco, como aconteceria com a opção `debug`.

Etapa 5: Instalar e configurar o Nginx

O Nginx atuará como um proxy reverso, encaminhando o tráfego HTTPS da porta 443 para o seu contêiner do n8n na porta 5678. Ele também lida com a terminação SSL, o que significa que o próprio n8n não precisa gerenciar certificados.

    sudo apt install nginx -y

Remova o site padrão e crie um novo bloco de servidor para o n8n:

    sudo rm /etc/nginx/sites-enabled/default
    sudo nano /etc/nginx/sites-available/n8n

Cole o seguinte:

    map $http_upgrade $connection_upgrade {
        default upgrade;
        ''      close;
    }
server {
    listen 80;
    server_name n8n.yourdomain.com;


    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        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;
        chunked_transfer_encoding on;
        proxy_buffering off;
        proxy_cache desativado;
        proxy_read_timeout 90s;
        client_max_body_size 50m;
    }
}

O bloco `map` no início lida corretamente com os cabeçalhos de atualização do WebSocket. O n8n usa WebSockets para atualizações em tempo real no editor; portanto, essa configuração é importante — sem ela, o editor visual não funcionará corretamente.

A diretiva client_max_body_size 50m permite que os fluxos de trabalho recebam cargas úteis grandes de webhooks. O limite padrão do Nginx é de 1 MB, o que é muito pequeno para fluxos de trabalho que processam uploads de arquivos ou respostas JSON grandes.

Habilite a configuração e teste-a:

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

Etapa 6: Emitir um certificado SSL com o Let’s Encrypt

Instale o Certbot e o plug-in do Nginx:

    sudo apt install certbot python3-certbot-nginx -y

Solicite um certificado para o seu domínio:

    sudo certbot --nginx -d n8n.yourdomain.com

Siga as instruções. Quando for perguntado se deseja redirecionar o tráfego HTTP para HTTPS, escolha Sim (opção 2). O Certbot atualizará automaticamente sua configuração do Nginx para lidar com esse redirecionamento e instalará a cadeia completa de certificados.

Verifique se a renovação automática está configurada corretamente:

    sudo certbot renew --dry-run

O Certbot instala um temporizador do systemd que renova os certificados automaticamente a cada 12 horas. Os certificados são renovados quando faltam menos de 30 dias para o vencimento. Você nunca precisará renová-los manualmente.

Passo 7: Inicie o n8n

Volte ao diretório do n8n e inicie todos os serviços:

    cd ~/n8n
    docker compose up -d

O Docker irá baixar as imagens do PostgreSQL e do n8n, criar os volumes, iniciar primeiro o PostgreSQL, aguardar até que a verificação de integridade seja aprovada e, em seguida, iniciar o n8n. Esse processo leva de 1 a 3 minutos na primeira execução.

Verifique se ambos os contêineres estão em execução:

    docker compose ps

Você deve ver tanto o `postgres` quanto o `n8n` listados com o status `Up`. Se o `n8n` aparecer como `Restarting`, verifique os logs:

    docker compose logs n8n --tail=50

Assim que ambos os contêineres estiverem em bom estado, abra seu navegador e acesse https://n8n.yourdomain.com. Será solicitado que você crie uma conta de proprietário com um endereço de e-mail e uma senha. Essa conta tem acesso administrativo total à sua instância do n8n.

Passo 8: Configure o n8n para iniciar na inicialização do sistema

A diretiva `restart: always` no seu arquivo `docker-compose.yml` garante que todos os contêineres sejam reiniciados automaticamente em caso de falha ou reinicialização do servidor.

Verifique isso reiniciando seu servidor:

    sudo reboot

Depois de se reconectar via SSH, verifique se o n8n voltou a funcionar automaticamente:

    docker compose -f ~/n8n/docker-compose.yml ps

Ambos os contêineres devem aparecer como em execução, sem qualquer intervenção manual.

Etapa 9: Configurar backups automatizados

Seus dados do n8n — fluxos de trabalho, credenciais e histórico de execução — ficam em dois locais: o banco de dados PostgreSQL e o volume Docker n8n_data (que armazena chaves de criptografia e algumas configurações). Faça backup de ambos regularmente.

Crie um script de backup:

    nano ~/n8n/backup.sh

Cole o seguinte:

    #!/bin/bash
    BACKUP_DIR="/home/n8nuser/backups"
    DATE=$(date +%Y-%m-%d_%H-%M)
    LOG_FILE="$BACKUP_DIR/backup.log"
# Verifique se o diretório de backup existe antes de qualquer outra coisa
mkdir -p "$BACKUP_DIR"


# Fazer o dump do PostgreSQL
DUMP_FILE="$BACKUP_DIR/n8n_db_$DATE.sql"
docker compose -f /home/n8nuser/n8n/docker-compose.yml exec -T postgres \
  pg_dump -U n8n n8n > "$DUMP_FILE"


# Verificar se o backup foi bem-sucedido e se o arquivo não está vazio
if [ $? -ne 0 ] || [ ! -s "$DUMP_FILE" ]; then
    echo "ERRO: Falha no backup do banco de dados em $DATE" >> "$LOG_FILE"
    rm -f "$DUMP_FILE"
    exit 1
fi


# Faça backup da chave de criptografia e das variáveis de ambiente
cp /home/n8nuser/n8n/.env "$BACKUP_DIR/n8n_env_$DATE.bak"
# Faça backup do volume n8n_data (configuração da instância e nós da comunidade instalados)
docker run --rm -v n8n_n8n_data:/data -v "$BACKUP_DIR":/backup alpine \
  tar czf /backup/n8n_data_$DATE.tar.gz -C /data .


# Compactar o dump do banco de dados
gzip "$DUMP_FILE"


# Manter apenas os backups dos últimos 7 dias
find "$BACKUP_DIR" -name "*.sql.gz" -mtime +7 -delete
find "$BACKUP_DIR" -name "*.bak" -mtime +7 -delete
find "$BACKUP_DIR" -name "n8n_data_*.tar.gz" -mtime +7 -delete


echo "Backup concluído: n8n_db_$DATE.sql.gz" >> "$LOG_FILE"

O nome do volume n8n_n8n_data vem do Docker Compose, que prefixa o volume com o nome da pasta do projeto (n8n). Confirme o seu com o comando docker volume ls.

Torne o script executável e agende-o com o cron:

    chmod +x ~/n8n/backup.sh
    crontab -e

Adicione esta linha para executar o backup todos os dias às 2h da manhã:

    0 2 * * * /home/n8nuser/n8n/backup.sh >> /home/n8nuser/backups/backup.log 2>&1

Para redundância externa, considere sincronizar seu diretório de backup com um provedor de armazenamento de objetos compatível com S3 usando o rclone ou o aws s3 sync.

Etapa 10: Ativar o fortalecimento básico de segurança

Configure um firewall

Instale o UFW e permita apenas as portas necessárias para o seu servidor:

    sudo ufw allow OpenSSH
    sudo ufw allow 'Nginx Full'
    sudo ufw enable

Verifique se as regras estão ativas:

    sudo ufw status verbose

Você deve ver as portas 22 (SSH), 80 (HTTP) e 443 (HTTPS) permitidas. Uma observação: o Docker define suas próprias regras de firewall e ignora o UFW para portas de contêineres publicadas. A porta 5678 permanece privada porque o arquivo compose a vincula a 127.0.0.1, e não por causa do UFW; portanto, nunca altere esse vínculo para 0.0.0.0.

Desative a autenticação por senha para SSH

Se você estiver usando chaves SSH (o que você deveria fazer), desative totalmente o login via SSH com senha. Primeiro, certifique-se de que a conta n8nuser consiga fazer login com sua chave. Na sua máquina local, execute:

    ssh-copy-id n8nuser@your_server_ip

Em seguida, edite a configuração do servidor SSH:

    sudo nano /etc/ssh/sshd_config

Defina os seguintes valores:

    PasswordAuthentication no
    PermitRootLogin no
    sudo systemctl restart ssh

Em muitas imagens de nuvem do Ubuntu, um arquivo em /etc/ssh/sshd_config.d/ (geralmente 50-cloud-init.conf) define PasswordAuthentication yes, e essa configuração prevalece porque o sshd usa o primeiro valor que encontra. Verifique qual configuração está realmente em vigor:

    sudo sshd -T | grep -i passwordauthentication

Deve ser exibido “passwordauthentication no”. Caso contrário, altere o valor no arquivo de substituição e reinicie o SSH novamente.

Não feche sua sessão atual do SSH até ter verificado se o login com chave funciona em uma nova janela do terminal.

Limite a taxa de acesso à página de login do n8n

Adicione um limite de taxa para retardar ataques de força bruta contra o endpoint de login do n8n.

**Importante: **A diretiva `limit_req_zone` deve estar dentro do bloco `http {}` na sua configuração principal do Nginx — não dentro do bloco `server`. Abra a configuração principal:

    sudo nano /etc/nginx/nginx.conf

Adicione esta linha dentro do bloco http {} existente:

    http {
        ...
        limit_req_zone $binary_remote_addr zone=n8n_login:10m rate=5r/m;
        ...
    }

Em seguida, na configuração do seu site n8n (/etc/nginx/sites-available/n8n), adicione este bloco `location` dentro do bloco `server` que escuta na porta 443 (criado pelo Certbot na Etapa 6), ao lado do `location` existente `/`. O Nginx não transfere os cabeçalhos de proxy do `location` `/`, portanto, eles são repetidos aqui:

    location /rest/login {
        limit_req zone=n8n_login burst=5 nodelay;
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        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;
    }

Reinicie o Nginx para aplicar as alterações:

    sudo nginx -t && sudo systemctl reload nginx

Isso limita cada endereço IP a aproximadamente 5 tentativas de login por minuto, com uma pequena tolerância para picos de tráfego.

Mantenha o n8n e o PostgreSQL atualizados

Baixe e reinicie regularmente com as imagens mais recentes:

    cd ~/n8n
    docker compose pull
    docker compose up -d

O Docker baixará as imagens mais recentes do n8nio/n8n e do PostgreSQL e reiniciará apenas os contêineres que tiverem uma versão mais recente disponível.

Para produção, considere fixar a imagem do n8n a uma tag de versão específica (docker.n8n.io/n8nio/n8n:<versão>, retirada das notas de lançamento do n8n) e atualizar deliberadamente, para que um pull de rotina nunca pule uma versão principal antes de você ter lido o changelog.

Solução de problemas comuns

O contêiner do n8n fica reiniciando

Verifique os logs do contêiner imediatamente após o início do ciclo de reinicialização:

    docker compose logs n8n --tail=100

Causas comuns:

• Falha na conexão com o banco de dados: verifique se o PostgreSQL está funcionando corretamente com o comando `docker compose ps`. Confira se a variável `POSTGRES_PASSWORD` no seu arquivo `.env` corresponde à senha usada na inicialização do banco de dados.
• Chave de criptografia ausente ou alterada: se N8N_ENCRYPTION_KEY não estiver definida ou tiver sido alterada após a primeira execução, o n8n não conseguirá descriptografar as credenciais armazenadas e irá travar.
• RAM insuficiente: o PostgreSQL e o n8n, juntos, podem usar de 1 a 1,5 GB de RAM. Verifique a memória disponível com o comando `free -h`.

Webhooks não estão funcionando

Os webhooks exigem que o n8n esteja acessível pela internet no seu domínio. Verifique:

1. O registro A do DNS do seu domínio aponta para o IP do seu VPS: dig n8n.seudominio.com
2. O Nginx está em execução: `sudo systemctl status nginx`
3. A porta 443 está aberta: `sudo ufw status`
4. A variável de ambiente WEBHOOK_URL corresponde exatamente ao seu domínio público, incluindo a barra final

O Editor do n8n não está carregando corretamente

Se o editor visual carregar, mas exibir uma tela de fluxo de trabalho em branco ou se as atualizações em tempo real deixarem de funcionar, a conexão WebSocket está falhando. Verifique se o bloco $http_upgrade está presente na sua configuração do Nginx e se você está usando a variável $connection_upgrade — e não a string literal “upgrade” — na linha proxy_set_header Connection.

Erros de certificado SSL

Se o Certbot falhar com um erro de validação de domínio, verifique se a porta 80 está acessível pela internet:

    curl -I http://n8n.yourdomain.com

Se a solicitação expirar, o firewall do seu provedor de VPS pode estar bloqueando a porta 80. Verifique as regras de firewall do console na nuvem, além do UFW.

Conclusão

Hospedar o n8n em um VPS Linux oferece uma plataforma de automação de fluxos de trabalho pronta para produção, sem limites de execução, com total privacidade de dados e flexibilidade para executar qualquer integração necessária. A configuração abordada neste guia — Docker, PostgreSQL, proxy reverso Nginx, SSL do Let’s Encrypt, backups automatizados e reforço de segurança — é a mesma pilha usada em ambientes de produção e oferece uma base estável e segura para você construir.

Ao contrário de uma instalação mínima com o comando `run` do Docker, essa configuração foi projetada para resistir a reinicializações do servidor, lidar com execuções simultâneas de fluxos de trabalho e se recuperar de forma controlada em caso de falhas. Suas credenciais são criptografadas, seus dados são copiados para backup todas as noites e seu endpoint de login tem limitação de taxa para proteção contra ataques de força bruta.

Assim que sua instância estiver em execução, explore os nós integrados do n8n para bancos de dados, APIs, webhooks e integrações de IA para começar a automatizar seus fluxos de trabalho imediatamente. O fórum da comunidade auto-hospedado em community.n8n.io também é um excelente recurso para ideias de fluxos de trabalho, solução de problemas com nós e dicas de implantação.