Como resolver problemas na VPS com n8n da HostGator

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), use:

• Parar containers atuais, digite:  

  docker compose down

• Depois, para especificar a versão anterior no docker-compose.yml, digite:  

  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

Substituía "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:

CONTAINER ID   IMAGE            COMMAND                  CREATED          STATUS          PORTS                                      NAMES
a57d7c13da01   n8nio/n8n        "tini -- /docker-ent…"   17 minutes ago   Up 16 minutes   5678/tcp                                   n8n-main
928109509dc9   traefik:latest   "/entrypoint.sh --pr…"   17 minutes ago   Up 16 minutes   0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   traefik

2Use o "CONTAINER ID" no comando abaixo para consultar os logs:

docker logs container_id 

Substituía o “container_id” pelo valor real, por exemplo: docker logs a57d7c13da01