O n8n não inicia porque binaryData e storage existem
Sintomas
- n8n 3.0 não inicia depois da atualização
- erro com binaryData e storage
- container reiniciando após atualizar para a v3
Antes de começar
Fazer o n8n 3.0 iniciar com os arquivos binários na pasta certa.
- Acesso ao servidor e aos volumes da instância.
- Backup completo feito antes da atualização.
Sintomas: o n8n para no primeiro início da 3.0 com erro sobre as pastas de arquivos binários. Em Docker, o container reinicia em sequência.
Por que acontece
No primeiro início, o n8n 3.0 renomeia ~/.n8n/binaryData para ~/.n8n/storage. Se as duas pastas existem, ele para com erro em vez de escolher uma delas. Isso costuma aparecer em instalações com volume montado em binaryData: a montagem recria a pasta antiga depois da renomeação.
Correção 1: montar o volume na pasta nova
Troque a montagem do volume de /home/node/.n8n/binaryData para /home/node/.n8n/storage no Compose ou na stack. Suba de novo.
Correção 2: manter o caminho antigo
Defina N8N_STORAGE_PATH com o caminho antigo. O n8n usa aquela pasta como armazenamento.
Correção 3: juntar as duas pastas
Quando as duas pastas já existem com arquivos:
- Pare o n8n.
- Mova o conteúdo de
~/.n8n/binaryDatapara~/.n8n/storage. - Apague
~/.n8n/binaryData. - Inicie o n8n de novo.
Faça esse passo com o backup em mãos. Instalações com os caminhos padrão e sem volume montado na pasta não precisam de ajuste.
Para conferir
Execute um workflow que grave ou leia um arquivo e confira que o arquivo aparece em storage.
Confira o resultado
O n8n inicia, o log não mostra o erro das duas pastas e um workflow com arquivo executa normalmente.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.