Resposta curta: num painel, o n8n sobe em poucos cliques. No Easypanel, crie um projeto, abra Templates, escolha n8n e clique em Create: ele já cria o n8n, o PostgreSQL e o runner de código. Depois, confira a versão da imagem e o domínio antes de usar em produção.
Se você prefere controlar cada linha do arquivo, o caminho é o n8n com Docker Compose e HTTPS. O painel vale quando você quer interface para logs, domínios, variáveis e atualização, e pretende rodar outros serviços na mesma VPS.
O que você precisa
Uma VPS limpa, com Linux, acesso root e as portas 80 e 443 livres. Instale o Easypanel antes de qualquer outra coisa: ele assume o proxy reverso (Traefik) da máquina e roda em cima do Docker Swarm. O plano gratuito permite até 3 projetos, o que sobra para o n8n.
Instale o Easypanel
Na VPS, como root, instale o Docker e depois o Easypanel (docs):
curl -sSL https://get.docker.com | sh
docker run --rm -it \
-v /etc/easypanel:/etc/easypanel \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
easypanel/easypanel setupAo terminar, o instalador mostra o endereço do painel, http://IP-DA-VPS:3000. Abra, crie o usuário administrador e, já no primeiro acesso, ative o domínio do painel em Settings para não deixar a porta 3000 exposta sem HTTPS.
Crie o projeto e o n8n pelo template
- No painel, clique em Create Project e dê um nome, como
automacoes. - Dentro do projeto, abra Templates, busque n8n e clique nele.
- O formulário traz três campos: nome do serviço, imagem do n8n e imagem do runner. Clique em Create.
O template cria três serviços: n8n, n8n-db (PostgreSQL) e n8n-runner, que executa os nós Code em processo separado. Ele já preenche a senha do banco, a N8N_ENCRYPTION_KEY e o token do runner. A primeira subida leva alguns minutos, enquanto as imagens são baixadas.
Atualize a versão da imagem
O template pode vir com uma versão antiga do n8n: a do formulário estava vários meses atrás da última estável. Veja a versão atual nas releases do n8n e na página de versão segura, e então:
- Abra o serviço n8n → Source, troque a imagem para
docker.n8n.io/n8nio/n8n:<versão>, clique em Save e depois em Deploy. - Faça o mesmo no n8n-runner, com
n8nio/runners:<mesma versão>.
Na subida da versão nova, o n8n roda as migrações do banco sozinho e os workflows continuam lá.
Coloque seu domínio
O template já publica o n8n num subdomínio gratuito *.easypanel.host, com HTTPS. Para usar o seu:
- No seu DNS, crie um registro
Aden8n.seudominio.com.brapontando para o IP da VPS. - Em n8n → Domains, clique em Add Domain, informe o domínio em Host e troque a porta de destino de
80para5678. - Na lista de domínios, clique na estrela do domínio novo, confirme em Make Primary e faça Deploy.
O passo 3 é o que mais se esquece: em Environment, o template define N8N_HOST e WEBHOOK_URL a partir do domínio principal ($(PRIMARY_DOMAIN)). Se o domínio novo não virar o principal, as URLs de webhook mostradas no editor continuam apontando para o subdomínio do Easypanel. Se o log avisar que WEBHOOK_URL está obsoleta (a partir do n8n 2.35), renomeie a variável para N8N_WEBHOOK_URL, com o mesmo valor.
Abra o domínio no navegador e crie a conta de dono (e-mail, nome e senha) na tela Set up owner account.
Quanto de memória o n8n usa
No painel, o serviço do n8n fica em torno de 370 a 490 MB de memória com o editor aberto e sem workflows rodando. Some o PostgreSQL, o runner, o próprio Easypanel e o Traefik: uma VPS de 2 GB funciona para uso leve, e com 4 GB sobra espaço para crescer e para outros serviços.
Depois de instalar
- Faça o backup do n8n e guarde a
N8N_ENCRYPTION_KEYfora do servidor. - Para escolher onde hospedar, veja a melhor VPS no Brasil para n8n e os requisitos de RAM e CPU.
- Para atualizar fora do painel, siga como atualizar o n8n.
Perguntas frequentes
O template do n8n no Easypanel usa PostgreSQL?
Sim. Ele cria três serviços: n8n, n8n-db (PostgreSQL) e n8n-runner, que executa os nós Code.
Como trocar o domínio do n8n no Easypanel?
Crie o registro A no DNS, adicione o domínio em Domains com a porta de destino 5678, marque o domínio novo como principal (Make Primary) e faça o Deploy. O template usa o domínio principal para definir N8N_HOST e WEBHOOK_URL.
Quanta memória o n8n usa no Easypanel?
O serviço do n8n fica em torno de 370 a 490 MB parado. Somando PostgreSQL, runner, Easypanel e Traefik, uma VPS de 2 GB atende uso leve e 4 GB dá folga.