Leve uma instalação npm para Docker
Antes de começar
Rodar a mesma instância, com os mesmos workflows e credenciais, em Docker, ainda na versão 2.x.
- Backup completo da instância npm.
- Docker instalado no servidor.
No n8n 3.0, a instalação self-hosted exige Docker. O projeto não publica mais o pacote executável no npm. A troca para Docker acontece antes da atualização para a v3, ainda na versão 2.x.
Por que não usar o script de uma linha aqui
O script get.n8n.io cria uma instância nova. Ele serve para instalações do zero. Para levar uma instância existente, o caminho é montar o Docker com a pasta .n8n atual, que guarda a chave de criptografia e, com SQLite, o banco.
Procedimento
-
Faça o backup completo e pare o n8n da instalação npm.
-
Localize a pasta
.n8n, em~/.n8npor padrão ou no caminho deN8N_USER_FOLDER. -
Crie um volume Docker e copie o conteúdo da pasta para ele, ou monte a pasta diretamente em
/home/node/.n8n. -
Suba o container na mesma versão que a instalação npm usava, com as mesmas variáveis de ambiente. Para SQLite:
Terminal docker run -d --name n8n \-p 5678:5678 \-e GENERIC_TIMEZONE="America/Sao_Paulo" \-e TZ="America/Sao_Paulo" \-v n8n_data:/home/node/.n8n \n8nio/n8n:<versao-atual> -
Com Postgres, acrescente as variáveis de conexão do banco que a instalação npm usava.
-
Abra o editor e confira usuários, workflows e uma credencial.
Pratique com a stack de estudos
Para praticar com Docker Compose antes de mexer na sua instância, use o guia da stack de estudos com Docker Compose e Traefik. Ele traz o .env e o compose.yaml completos, com Postgres.
Depois da troca
Com a instância rodando em Docker na 2.x, siga para o tutorial de atualização com Docker Compose.
Confira o resultado
A instância em Docker abre com os mesmos usuários, workflows e credenciais da instalação npm, na mesma versão 2.x.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.
