Como resolver problemas na VPS com n8n da HostGator

A VPS com n8n roda sobre AlmaLinux usando Docker Compose. Durante atualizações, importações, erros de execução ou falhas inesperadas, pode ser necessário fazer alguns ajustes direto no terminal da VPS (SSH).

Este guia reúne os comandos essenciais para diagnosticar, reiniciar ou recuperar sua instância n8n quando algo não funciona como esperado.

Consulte como verificar:

1Acesse o SSH - Se necessário, confira como acessar

2Escolha o que deseja:

• Verificar os logs do n8n
• Verificar se o Docker está funcionando
• Verificar conectividade entre serviços
• Verificar recursos usados
• Descobrir o usuário do banco de dados PostgreSQL
• Reiniciar os contêineres
• Fazer backup
• Restaurar workflows (fluxos de trabalho)
• Contêineres que não respondem
• Limpar cache do Docker
• Limpar logs do sistema

Verificar logs do n8n

Os logs ajudam a identificar erros como:

• Container reiniciando em loop
• Erro 502 Bad Gateway
• Falha no banco de dados (SQLite ou Postgres)
• Workflows com erro de execução
• Traefik não iniciando ou falhando no HTTPS

Como verificar: 

Se estiver no diretório onde está o arquivo docker-compose.yml, use o comando:

 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

Para verificar logs de um container específico, utilize os comandos:

docker logs n8n-main

docker logs postgres

docker logs redis

docker logs traefik

Verificar se o Docker está funcionando

No terminal, para verificar se o Docker está rodando, execute o comando:

systemctl status docker

Se aparecer "inactive", inicie com:

systemctl start docker

Verificar conectividade entre serviços

Se o n8n mostra erro 502 ou não consegue conectar ao banco de dados:

- Teste a conexão com PostgreSQL com o comando:

 docker exec -it postgres psql -U db_user -d postgres -c "\l"

- Verifique se o container está rodando com o comando:

docker ps | grep postgres

- Verifique os logs do postgres com o comando:

docker logs postgres | tail -20

- Teste a conexão com Redis com o comando:

docker exec -it redis redis-cli ping

Deve retornar: PONG

Se não responder:

- Verifique se está rodando com o comando:

docker ps | grep redis

- Verifique os logs com o comando:

docker logs redis | tail –20

- Reinicie se necessário com o comando:

docker restart redis

Se ambos os serviços estiverem OK, reinicie o n8n com o comando:

docker restart n8n-main 
sleep 10 
docker logs n8n-main | tail -20

Descobrir o usuário do banco de dados PostgreSQL

1Para verificar as variáveis de ambiente do container PostgreSQL, utilize:

docker exec -it postgres env | grep POSTGRES

Isso mostrará as variáveis como:

• POSTGRES_USER= (nome do usuário)
• POSTGRES_PASSWORD=
• POSTGRES_DB=

2Verifique o docker-compose.yml com o comando:

cat /opt/n8n-traefik/docker-compose.yml | grep -A 10 postgres

Reiniciar os containers

Reinicie os containers sem alterar a versão do n8n, quando ocorrerem problemas como: 

Para solucionar, siga estes passos: 

1Acesse o diretório do projeto, digite o comando:

cd /opt/n8n-traefik/

2Em seguida, para 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) com o comando:

docker compose up -d

4Verifique se subiram corretamente executando o comando: 

docker ps

Você deve visualizar containers como:

• n8n-main
• postgres
• redis
• traefik

5Aguarde 30 segundos e teste o acesso ao n8n no navegador

Restaurar workflows (fluxos de trabalho)

1Crie o diretório de backup dentro do container (caso ainda não exista) com o comando:

docker exec -it n8n-main mkdir -p /home/node/n8n-backup/$(date)

2Copie o arquivo de backup para dentro do container com o comando:

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:

Contêineres que não respondem

Confira como:

1Liste os contêineres ativos, 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

Esse comando é útil para identificar falhas específicas de cada serviço (n8n, traefik, banco, etc).

Limpar cache do Docker

Execute o comando: 

 docker system prune -a –volumes

Limpar logs do sistema

Execute o comando: 

 journalctl --vacuum-time=7d