Resposta curta: instale o Coolify com o script oficial como root, já passando ROOT_USERNAME, ROOT_USER_EMAIL e ROOT_USER_PASSWORD para a tela de cadastro nunca ficar aberta. No painel, escolha This machine como servidor, crie um projeto e, em + New, procure “n8n” e escolha N8N With Postgresql. Depois troque o domínio para https:// com a porta 5678 e reinicie o serviço.
O Coolify é um painel open source no estilo Heroku/Vercel que roda na sua própria VPS. Ele usa Docker por baixo, coloca um Traefik na frente para domínio e HTTPS e tem um catálogo de serviços prontos, n8n incluído. Se você prefere um painel mais enxuto, veja também o n8n com Easypanel. Se prefere o arquivo na mão, veja o n8n com Docker Compose.
Antes de começar
- Máquina: a documentação do Coolify pede no mínimo 2 núcleos, 2 GB de RAM e 10 GB livres de disco. Com o n8n rodando, o conjunto ficou perto de 1 GB de RAM: Coolify em torno de 450 MB, n8n em torno de 320 MB, Traefik uns 115 MB e o resto com os bancos. Uma VPS de 4 GB dá folga.
- Disco: as imagens do Coolify, do Traefik e do n8n com PostgreSQL somam uns 5 GB.
- Sistema: Debian, Ubuntu LTS, Alpine, Fedora, Rocky, Arch e outros estão na lista de suportados. Prefira uma VPS limpa, sem nada escutando nas portas 80 e 443.
- Portas: 22 (SSH), 80 e 443 (Traefik), 8000 (painel), 6001 e 6002 (atualizações em tempo real do painel).
Instale o Coolify sem deixar o cadastro aberto
Logo depois da instalação, o Coolify abre uma página de registro, e quem chegar primeiro vira o administrador, com acesso root ao servidor. Para evitar isso, passe o admin já no comando. Entre como root (sudo -i) e rode:
env ROOT_USERNAME=seu-usuario \
[email protected] \
ROOT_USER_PASSWORD='SenhaForte123!' \
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'A senha precisa de 8 caracteres ou mais, com maiúscula, minúscula, número e símbolo. O e-mail tem que ter um domínio válido. No Alpine, o bash não vem na instalação padrão, então rode apk add bash curl antes do comando.
O script instala o Docker se ele não existir, configura o daemon, baixa as imagens, gera uma chave SSH e sobe o Coolify. Leva por volta de um minuto e termina com “Coolify is ready!” e os endereços do painel, no formato http://IP-DA-VPS:8000.
sudo -E. Com sudo -E, a variável HOME continua sendo a do seu usuário, e o script grava a chave pública do Coolify no authorized_keys do seu usuário, não no do root. O sintoma aparece no primeiro acesso: o painel diz "Server is not reachable" com [email protected]: Permission denied (publickey).
Se já caiu nisso, copie a chave para o root e clique em Check Again:
sudo sh -c 'ssh-keygen -y -f "$(ls /data/coolify/ssh/keys/ssh_key@* | grep -v lock)" \
>> /root/.ssh/authorized_keys'Guarde uma cópia do /data/coolify/source/.env fora do servidor, num gerenciador de senhas por exemplo. Ele tem o APP_KEY, que criptografa os dados do Coolify, e você precisa dele para restaurar um backup.
Primeiro acesso
- Abra
http://IP-DA-VPS:8000e entre com o e-mail e a senha do comando. - Na tela Welcome to Coolify, clique em Continue.
- Em Choose Server Type, escolha This machine. O Coolify se conecta por SSH ao próprio servidor e valida o Docker.
- Em Project Setup, clique em Create “My First Project”. Ele já vem com o ambiente
production.
Depois, abra Servers → localhost → Proxy. Se o Traefik aparecer como Exited, clique em Start Proxy. Sem ele, nenhum domínio funciona.
Crie o n8n pelo catálogo
- Em Projects, abra o projeto e o ambiente
production. - Clique em + New e, em Search resources, digite
n8n. - Aparecem três opções: N8N (com SQLite), N8N With Postgresql e N8N With Postgres And Worker (queue mode com worker). Para a maioria dos casos, escolha N8N With Postgresql e clique em Deploy.
O Coolify cria o serviço com três containers: o n8n, os Task Runners (que executam os nós de código) e o PostgreSQL 16. Usuário, senha e nome do banco já vêm gerados, e os dados ficam em volumes Docker. Clique em Deploy no topo e espere os três ficarem Running (healthy), o que levou cerca de um minuto.
Por que PostgreSQL: com volume de execuções, o SQLite vira gargalo. O porquê está em n8n com PostgreSQL. Se for precisar de vários workers, leia antes o queue mode com Redis.
Domínio e HTTPS
O Coolify gera um domínio provisório no formato http://n8n-xxxx.IP.sslip.io. Esse endereço é só HTTP, e o n8n bloqueia o acesso com a mensagem “Your n8n server is configured to use a secure cookie”. Então configure o domínio com HTTPS antes de usar:
- No seu DNS, crie um registro A para
n8n.seudominio.comapontando para o IP da VPS. - No serviço, abra Domains e clique na engrenagem do domínio.
- Em Protocol, escolha https. Em Domain, coloque
n8n.seudominio.com. Em Port, coloque5678. - Clique em Save e, depois, em Restart current version no topo.
Se o campo Port ficar vazio, o Coolify avisa “This service requires port 5678 to function correctly”. Preencha 5678 antes de salvar.
Com o domínio em https://, o Traefik do Coolify pede o certificado Let’s Encrypt sozinho, e para isso o DNS tem que estar propagado e as portas 80 e 443 abertas. O Coolify também preenche N8N_HOST, N8N_EDITOR_BASE_URL, WEBHOOK_URL e N8N_PROTOCOL=https a partir desse domínio, e é isso que faz os webhooks saírem com a URL certa. Não precisa mexer nessas variáveis à mão.
Primeiro acesso ao n8n
- Abra
https://n8n.seudominio.com. Aparece Set up owner account: preencha e-mail, nome e senha (8 ou mais caracteres, com número e maiúscula). - O n8n mostra um questionário e oferece uma chave de licença grátis para recursos extras. Os dois são opcionais.
- Crie um workflow com o nó Manual Trigger ligado a um Edit Fields e clique em Execute workflow. Os dois nós ficam verdes, com “1 item” entre eles, e a execução aparece na aba Executions como Succeeded.
Vale reiniciar o serviço uma vez pelo Coolify e conferir se o workflow e o histórico de execuções continuam lá. Continuam, porque o n8n e o PostgreSQL gravam em volumes.
Segurança e manutenção
- Feche a porta 8000 quando puder. Em Settings → General, o campo URL coloca o próprio painel atrás de um domínio, e aí você libera só 22, 80 e 443 no firewall.
- Backup: o PostgreSQL do serviço tem a aba Backups no Coolify. Mesmo assim, exporte também os workflows e as credenciais, como está no backup do n8n.
- Atualizar o n8n: o serviço usa uma tag fixa da imagem. Antes de trocar, leia como atualizar o n8n e confira a versão segura do n8n.
Onde hospedar
Para Coolify com n8n, 4 GB de RAM é o tamanho confortável. O Hostinger KVM 1 (1 vCPU, 4 GB) cobre a memória, mas fica abaixo dos 2 núcleos que o Coolify pede. O KVM 2 (2 vCPU, 8 GB) atende os requisitos com folga ver plano ↗. Compare preços em reais em quanto custa hospedar n8n e veja a melhor VPS no Brasil para n8n.
Perguntas frequentes
Qual template de n8n escolher no Coolify?
Para a maioria dos casos, N8N With Postgresql: sobe o n8n, os Task Runners e um PostgreSQL 16 com usuário e senha gerados. O N8N simples usa SQLite, e o N8N With Postgres And Worker é para queue mode.
Por que o n8n no Coolify mostra o erro de secure cookie?
Porque o domínio provisório do sslip.io é só HTTP. Configure um domínio próprio com https:// e porta 5678 em Domains e reinicie o serviço. O Traefik do Coolify emite o certificado.
O que fazer quando o Coolify diz Server is not reachable no localhost?
A chave SSH do Coolify não está no authorized_keys do root. Isso acontece ao instalar com sudo -E. Copie a chave pública de /data/coolify/ssh/keys para /root/.ssh/authorized_keys e clique em Check Again.
Quanta RAM o Coolify com n8n usa?
Por volta de 1 GB no total: o Coolify fica em torno de 450 MB, o n8n em torno de 320 MB e o Traefik uns 115 MB. Uma VPS de 4 GB dá folga.