Hospedando o n8n no seu próprio servidor

O n8n é uma ferramenta de automação que conecta apps e permite criar workflows. Você pode rodá-lo no seu próprio VPS com Docker. A documentação oficial apresenta uma instalação com Docker Compose e recomenda a hospedagem própria para quem tem experiência técnica. Os guias de instalação não dão um valor de CPU, RAM ou disco, então faz sentido começar com um servidor pequeno e aumentar conforme você observa o uso.

Este artigo trata da licença, dos passos de instalação, das configurações que importam, dos backups e das atualizações.

O que você cria com o n8n?

Um workflow no n8n é um gatilho mais as etapas ligadas a ele. O gatilho pode ser um agendamento, um webhook ou um evento em outro app. Exemplos típicos: gravar o envio de um formulário em uma planilha, avisar a equipe sobre um novo pedido ou reunir um relatório toda manhã e enviá-lo por e-mail. Você cria workflows em um editor visual no navegador. Não é obrigatório escrever código, mas você pode adicionar uma etapa de código se quiser.

Por que rodá-lo no seu próprio servidor?

• Seus workflows e os dados de conexão salvos ficam no seu próprio servidor.
• Os workflows agendados continuam rodando no servidor enquanto o seu computador está desligado, e webhooks podem acioná-los de fora.
• Seu limite de uso é definido pela potência do seu servidor e, se não for suficiente, você aumenta o servidor.
• Em troca, a manutenção é sua: atualizações, backups e segurança.

Licença: o que o uso gratuito permite?

O n8n não é de código aberto. Pela própria descrição, é um software "fair-code". O código-fonte está disponível, mas a Sustainable Use License restringe o uso comercial. Segundo a página oficial da licença, você pode usá-lo gratuitamente nas operações internas da sua empresa e em projetos pessoais ou sem fins comerciais. Criar workflows para clientes como consultoria paga também é permitido, desde que os clientes não tenham acesso ao n8n em si. Oferecer um serviço em que os clientes entram no n8n para criar ou editar os próprios workflows (hospedar o n8n como serviço) exige uma licença comercial. Para casos limítrofes, consulte a equipe de licenciamento do n8n.

Passos da instalação

Estes passos seguem o guia oficial do Docker Compose. O guia obtém e renova o certificado HTTPS por meio de um proxy reverso chamado Traefik.

1. Prepare um servidor Linux com o Docker Engine e o Docker Compose instalados. Confira com docker --version e docker compose version.
2. Adicione um registro A que aponte um subdomínio do seu domínio (por exemplo, n8n.example.com) para o endereço IP do servidor. Como conectar seu próprio domínio mostra o passo a passo.
3. Crie no servidor os arquivos .env e compose.yaml do guia oficial.
4. Preencha DOMAIN_NAME, SUBDOMAIN, GENERIC_TIMEZONE e SSL_EMAIL no .env. Use Europe/Istanbul como fuso horário. Se você deixar de fora, o padrão é Nova York.
5. Inicie: docker compose up -d
6. Abra seu subdomínio em um navegador e crie a conta de proprietário na hora. Quem preencher essa tela primeiro se torna o proprietário.

Configurações que você deve conhecer

O nó Webhook tem dois endereços: o endereço de teste funciona enquanto você edita o workflow e o endereço de produção funciona depois que você o ativa. Dê aos serviços externos o endereço de produção. O início do endereço vem do valor de N8N_WEBHOOK_URL, então, se esse valor estiver errado, os serviços externos não alcançam o seu workflow.

A chave de criptografia e os backups

Na primeira inicialização, o n8n gera uma chave de criptografia aleatória e a guarda na pasta de dados dele (/home/node/.n8n). Suas conexões salvas são criptografadas com ela. Os dados de conexão de um banco restaurado não podem ser descriptografados sem a chave. Guarde uma cópia separada da chave.

• O que incluir no backup: O volume de dados (n8n_data) guarda o banco SQLite padrão e a chave. Pare o n8n antes de copiar. Se você usa PostgreSQL, faça o backup do banco separadamente, com as ferramentas dele.
• Exportação rápida: Os comandos do n8n rodam dentro do contêiner. docker compose exec n8n n8n export:workflow --backup --output=/home/node/.n8n/backups/workflows/ e docker compose exec n8n n8n export:credentials --backup --output=/home/node/.n8n/backups/credentials/ gravam os workflows e as conexões no volume de dados. Usuários, histórico de execuções e configurações não estão incluídos, então isso não basta para uma recuperação completa.
• Backup do servidor: A Seturack faz backup do seu servidor toda noite e mantém os últimos 7 dias. Isso cobre também os dados do n8n, mas é uma boa ideia exportar separadamente seus workflows críticos.

Recursos e banco de dados

Os guias de instalação oficiais não dão um valor de CPU ou de memória. Como regra prática, workflows leves e pouco frequentes rodam em um servidor pequeno, enquanto workflows que lidam com arquivos grandes ou muitos dados precisam de memória. Acompanhe o uso real do contêiner com docker stats. O banco de dados padrão é o SQLite. Para uso pesado, você muda para o PostgreSQL com DB_TYPE=postgresdb e continua mantendo o volume da pasta de dados.

Se o servidor não for suficiente, aumente-o pelo painel. Seu endereço IP e seus dados continuam os mesmos, e as URLs de webhook não mudam.

Atualizando

O guia oficial descreve a atualização em três comandos: docker compose pull, docker compose down e docker compose up -d. Faça um backup antes e leia as notas de versão. As atualizações do sistema operacional e dos aplicativos ficam por sua conta depois da instalação.

Segurança

• Abra o n8n apenas por HTTPS. O guia oficial adota a mesma abordagem.
• Crie a conta de proprietário logo depois da instalação e escolha uma senha forte.
• Mantenha abertas no firewall apenas as portas 22, 80 e 443. Como o Docker ignora as regras do ufw nas portas que publica, não publique a porta 5678 do n8n para o exterior.

Se preferir pular esses passos, escolha seu servidor com o n8n pré-instalado. Se for instalar por conta própria, comece por um servidor com o Docker instalado.