Migrar o n8n é simples quando três coisas viajam juntas: o banco, a chave de criptografia e o endereço dos webhooks.
- Sem a mesma chave de criptografia, as credenciais não abrem.
- Desligue os gatilhos da instância antiga para não duplicar execuções.
- Mantenha o mesmo domínio para não mexer nos webhooks.
Hora de mudar o n8n de máquina. As credenciais ficam criptografadas no banco, os webhooks dependem do endereço e os gatilhos de agenda disparam onde estiverem ligados. Por isso a ordem importa.
Antes de mudar
Anote a N8N_ENCRYPTION_KEY da instância atual: sem ela, o n8n novo não consegue ler as credenciais. Instale a mesma versão do n8n no destino e use o mesmo domínio, para que as URLs de webhook continuem iguais.
A cópia do banco
Com o Postgres, um dump e um restore levam o histórico, os fluxos e as credenciais de uma vez:
pg_dump -Fc -d n8n -f n8n.dump
pg_restore -d n8n --no-owner n8n.dumpSe o banco atual tem muito histórico, limpe antes, como mostra o guia de como medir o n8n. O dump fica menor e a cópia, mais rápida.
A troca
Pare a instância antiga, ou desative os fluxos com gatilho de agenda, para que nada rode em dois lugares ao mesmo tempo. Faça o dump final, restaure no destino, suba o n8n novo e aponte o DNS. Teste um webhook real e confira se os fluxos agendados rodaram no horário.
O plano de volta
Mantenha a instância antiga parada, mas intacta, por uma semana. Se algo der errado, aponte o DNS de volta e religue. Se a mudança também vai juntar outras ferramentas na mesma máquina, veja uma máquina ou várias VPS; se o volume pede, já suba no modo fila.
