Durante o uso do n8n, como atualizações, importações ou erros de execução, pode ser necessário realizar alguns ajustes diretamente no terminal do servidor via SSH.
Neste artigo, você encontra comandos essenciais para diagnosticar e resolver problemas comuns no ambiente Docker Compose do n8n.
Confira alguns comandos:
- Verificar logs
- Reiniciar os contêineres
- Restaurar workflows (fluxos de trabalho) a partir de um backup
- Contêineres que não respondem
Verificar logs
Se estiver no diretório onde está o arquivo docker-compose.yml, use:
docker compose logs -f
Se estiver fora do diretório, especifique o caminho completo:
docker compose -f /opt/n8n-traefik/docker-compose.yml logs –f
Reiniciar os containers
Para reiniciar os containers sem alterar a versão do n8n, siga estes passos:
1Acesse o diretório do projeto, para isso no terminal, digite o comando:
cd /opt/n8n-traefik/
2Em seguida, parar e remover os containers atuais, digite o comando:
docker compose down
3Depois, inicie os containers novamente com a mesma configuração (versão atual do n8n):
docker compose up -d
Restaurar workflows (fluxos de trabalho) a partir de um backup
1Crie o diretório de backup dentro do container (caso ainda não exista):
docker exec -it n8n-main mkdir -p /home/node/n8n-backup/$(date)
2Copie o arquivo de backup para dentro do container:
docker cp /root/n8n-backup/20250717/workflows.json n8n-main:/home/node/n8n-backup/$(date)/workflows.json
Substitua "root/n8n-backup/20250717/workflows.json" pelo caminho real
3Agora, importe os workflows:
docker exec -it n8n-main n8n import:workflow --input=/home/node/n8n-backup/$(date)/workflows.json
4Após isto:
- Workflows existentes serão sobrescritos com os dados do backup
- Workflows criados após o backup permanecerão
- Workflows que foram removidos serão recriados
Contêineres que não respondem
Se os contêineres em execução não estiverem respondendo ou com o comportamento inesperado, você pode verificar os logs para entender o que está acontecendo.
Confira como:
1Primeiro você precisa pegar o container-id, para isso, digite o comando:
docker ps
Exemplo de resposta:
2Use o "CONTAINER ID" no comando abaixo para consultar os logs:
docker logs container_id
Substitua o “container_id” pelo valor real, por exemplo: docker logs a57d7c13da01