Ir para o conteúdo
Promovaweb

Leve uma instalação npm para Docker

Revisado em

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

  1. Faça o backup completo e pare o n8n da instalação npm.

  2. Localize a pasta .n8n, em ~/.n8n por padrão ou no caminho de N8N_USER_FOLDER.

  3. Crie um volume Docker e copie o conteúdo da pasta para ele, ou monte a pasta diretamente em /home/node/.n8n.

  4. 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>
  5. Com Postgres, acrescente as variáveis de conexão do banco que a instalação npm usava.

  6. 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.