Instalar n8n na VPS: passo a passo com Docker

Do servidor atualizado ao painel com HTTPS: veja como subir o n8n com Docker, configurar webhooks e manter as automações seguras e atualizadas.

Por Redação Eleven Host · @robson.direitodigital · 22 de outubro de 2026 · 8 min de leitura

Com Docker, subdomínio e HTTPS, o n8n roda no seu próprio servidor e recebe webhooks de qualquer serviço. Arte: Eleven Host

Para instalar n8n na VPS, o caminho mais usado é o Docker: você instala o Docker no servidor, sobe o container oficial do n8n com um volume para guardar os dados e coloca um proxy reverso com HTTPS na frente, usando um subdomínio seu.

Este guia mostra o passo a passo para um servidor Linux com Ubuntu ou Debian, explica cada peça sem jargão e lista os cuidados que evitam os problemas mais comuns: webhooks que não funcionam, dados perdidos ao atualizar e painel exposto sem proteção.

Antes de começar: o que você precisa

Instalar o n8n por conta própria dá controle total sobre a ferramenta, mas pede alguns itens prontos antes do primeiro comando. Separe tudo antes para não parar no meio.

• Uma VPS com Linux: Ubuntu ou Debian são os mais usados nos tutoriais e facilitam a vida.
• Acesso SSH: o endereço IP, o usuário e a senha ou chave enviados pelo provedor.
• Um domínio próprio: você vai criar um subdomínio, como n8n.suaempresa.com.br, para acessar o painel com HTTPS.
• Noções básicas de terminal: copiar comandos, editar um arquivo de texto e ler mensagens de erro.

Sobre o tamanho do servidor, um plano de entrada costuma bastar para começar com poucos fluxos. Acompanhe o uso de memória e processador conforme as automações crescem. Se você ainda não fez o primeiro acesso ao servidor, comece pelo guia como montar servidor VPS do plano ao primeiro site.

Passo 1: prepare o servidor

Conecte por SSH e atualize o sistema. Isso garante que você parte de pacotes corrigidos e evita conflitos na instalação.

1. Conecte: ssh usuario@IP_DA_VPS
2. Atualize: sudo apt update && sudo apt upgrade -y
3. Ative o firewall liberando só o necessário: sudo ufw allow OpenSSH, sudo ufw allow 80/tcp, sudo ufw allow 443/tcp e depois sudo ufw enable

Repare que a porta do n8n (5678) não foi liberada. Isso é proposital: o painel vai ser acessado pelo proxy reverso, nas portas 80 e 443, e nunca direto pela porta do container.

Passo 2: aponte um subdomínio para a VPS

No painel de DNS do seu domínio, crie um registro do tipo A com o nome n8n apontando para o IP da VPS. Assim, n8n.suaempresa.com.br passa a levar até o seu servidor.

Faça isso cedo, porque a mudança pode levar de alguns minutos a algumas horas para valer em todas as redes. O certificado HTTPS só é emitido depois que o subdomínio já aponta para a VPS. Para conferir, rode ping n8n.suaempresa.com.br e veja se aparece o IP do servidor.

Passo 3: instale o Docker

O Docker roda o n8n isolado do resto do sistema, o que facilita atualizar, mover e reiniciar. O próprio Docker oferece um script de instalação para Ubuntu e Debian.

1. Instale: curl -fsSL https://get.docker.com | sudo sh
2. Confira a versão: docker --version
3. Confira o Compose: docker compose version

Se os dois comandos de conferência responderem com um número de versão, o Docker está pronto. Prefira sempre a instalação oficial em vez de pacotes antigos do sistema.

O que separa um n8n de teste de um n8n de produção não é o servidor: é ter HTTPS, dados guardados em volume e backup antes de cada atualização.

Passo 4: suba o n8n com Docker Compose

Crie uma pasta para o projeto, por exemplo com mkdir ~/n8n && cd ~/n8n, e dentro dela um arquivo chamado docker-compose.yml. Nele você descreve o container do n8n e o proxy reverso. Os pontos principais do serviço do n8n são:

• Imagem oficial: docker.n8n.io/n8nio/n8n.
• Porta só local: 127.0.0.1:5678:5678, para que a porta não fique aberta para a internet.
• Volume de dados: n8n_data:/home/node/.n8n, onde ficam fluxos, credenciais e a chave de criptografia.
• Endereço público: as variáveis N8N_HOST=n8n.suaempresa.com.br, N8N_PROTOCOL=https e WEBHOOK_URL=https://n8n.suaempresa.com.br/.
• Fuso horário: GENERIC_TIMEZONE=America/Sao_Paulo e TZ=America/Sao_Paulo, para os agendamentos rodarem no horário certo.
• Reinício automático: restart: unless-stopped, para o n8n voltar sozinho se a VPS reiniciar.

A variável WEBHOOK_URL merece atenção. Sem ela, o n8n pode gerar endereços de webhook com localhost, e serviços externos não conseguem chamar seus fluxos. Esse é o erro mais comum de quem instala pela primeira vez.

Prefere pular a instalação? Tenha o n8n pronto para usar, sem cuidar de servidor. Ver planos de n8n

Passo 5: coloque HTTPS com proxy reverso

O proxy reverso recebe os acessos nas portas 80 e 443, cuida do certificado HTTPS e repassa tudo para o n8n na porta local. O Caddy é uma opção simples, porque emite e renova o certificado automaticamente.

Com o Caddy, a configuração cabe em duas linhas no arquivo Caddyfile: o nome n8n.suaempresa.com.br seguido de reverse_proxy apontando para o n8n. Se você preferir Nginx, o resultado é o mesmo, mas o certificado precisa ser emitido à parte, por exemplo com o Certbot.

Com os arquivos prontos, suba tudo com docker compose up -d e acompanhe as mensagens com docker compose logs -f. Quando o log indicar que o n8n está pronto, abra https://n8n.suaempresa.com.br no navegador e crie a conta de proprietário, que é o primeiro acesso de administrador.

Entenda

1. Atualize a VPS e libere só SSH, 80 e 443 no firewall.
2. Aponte um subdomínio (registro A) para o IP da VPS.
3. Instale o Docker pelo script oficial.
4. Suba o n8n com volume, WEBHOOK_URL e fuso horário configurados.
5. Coloque um proxy reverso com HTTPS e crie a conta de proprietário.

Cuidados depois da instalação

Com o n8n no ar, o trabalho muda de instalar para manter. Alguns hábitos simples evitam surpresas.

• Crie a conta de proprietário logo: não deixe o painel recém-instalado aberto sem dono, porque qualquer pessoa que acessar o endereço primeiro poderia configurá-lo.
• Guarde a chave de criptografia: as credenciais salvas no n8n são protegidas por uma chave que fica no volume de dados. Sem ela, um backup restaurado não abre as credenciais.
• Faça backup antes de atualizar: exporte os fluxos e copie o volume antes de trocar a versão.
• Atualize com calma: rode docker compose pull e docker compose up -d, e leia as notas da versão quando houver mudança grande.
• Acompanhe o consumo: fluxos com muitas execuções ou arquivos grandes aumentam o uso de memória.

Se as automações começarem a travar ou demorar, o servidor pode ter ficado pequeno. O guia VPS lento: 6 sinais de que ficou pequeno ajuda a identificar a hora de subir de plano.

Problemas comuns e como resolver

Mesmo seguindo o roteiro, algumas mensagens de erro aparecem com frequência na primeira instalação. Quase sempre a causa é simples e está em uma das etapas anteriores.

• O navegador não abre o endereço: confira se o registro A já aponta para o IP certo e se as portas 80 e 443 estão liberadas no firewall.
• Aviso de site não seguro: o certificado ainda não foi emitido. Veja os logs do proxy reverso; em geral, o DNS ainda não tinha propagado quando o proxy subiu.
• Erro de permissão no volume: o n8n roda com um usuário próprio dentro do container. Use um volume nomeado do Docker, como no exemplo, em vez de uma pasta criada à mão como root.
• Agendamentos no horário errado: faltou definir o fuso horário nas variáveis do container ou nas configurações do fluxo.
• O n8n some depois de reiniciar a VPS: confira se o serviço tem restart: unless-stopped e se o Docker inicia junto com o sistema.

Quando nada disso resolver, leia as últimas linhas de docker compose logs. A mensagem de erro costuma dizer exatamente qual variável ou arquivo está com problema.

Instalar na VPS ou usar n8n gerenciado?

Instalar o n8n na própria VPS faz sentido para quem quer controle total, já administra servidores ou vai rodar outras coisas na mesma máquina, como um site ou um banco de dados. Na Eleven Host, os planos de VPS começam a partir de R$ 17,00/mês no Plano Bronze.

Se o seu foco é criar automações e não manter servidor, um plano de n8n pronto elimina as etapas de Docker, proxy e atualização. Na Eleven Host, os planos de n8n começam a partir de R$ 19,90/mês no n8n Essencial. A escolha depende de quanto tempo você quer gastar com infraestrutura.

Monte sua VPS para rodar o n8n e outros projetos no mesmo servidor. Contratar VPS

Perguntas frequentes

Preciso de domínio para instalar n8n na VPS?

Para testar, dá para acessar pelo IP. Para uso real, sim: o domínio permite HTTPS, e muitos serviços só aceitam webhooks em endereços seguros.

Dá para instalar o n8n sem Docker?

Sim, com Node.js e npm. O Docker é mais usado porque isola a instalação e simplifica atualizar e mover o n8n de servidor.

Por que meus webhooks mostram localhost?

Falta configurar a variável WEBHOOK_URL com o endereço público em HTTPS. Ajuste, reinicie o container e gere o webhook de novo.

O n8n instalado na VPS tem limite de execuções?

Na instalação própria, o limite prático vem dos recursos do servidor, como memória e processador. Acompanhe o consumo e suba de plano quando precisar.