La VPS con n8n funciona sobre AlmaLinux usando Docker Compose. Durante actualizaciones, importaciones, errores de ejecución o fallas inesperadas, puede ser necesario hacer algunos ajustes directamente en el terminal de la VPS (SSH).

Esta guía reúne los comandos esenciales para diagnosticar, reiniciar o recuperar tu instancia n8n cuando algo no funciona como se espera.

Consulta cómo verificar:

1 Accede al SSH - Si es necesario, consulte cómo acceder

2 Elige lo que deseas:

• Verificar los logs de n8n
• Verificar si Docker está funcionando
• Verificar conectividad entre servicios
• Verificar los recursos utilizados
• Descubrir el usuario de la base de datos PostgreSQL
• Reiniciar los contenedores
• Hacer una copia de seguridad
• Restaurar workflows (flujos de trabajo)
• Contenedores que no responden
• Limpiar caché de Docker
• Limpiar logs del sistema

Verificar los logs de n8n

Los logs ayudan a identificar errores como: 

• Contenedor reiniciando en bucle 
• Error 502 Bad Gateway 
• Fallo en la base de datos (SQLite o Postgres) 
• Workflows con error de ejecución 
• Traefik no iniciando o fallando en HTTPS 

Cómo verificar: 

Si estás en el directorio donde está el archivo docker-compose.yml, usa el comando: 

docker compose logs -f 

Si estás fuera del directorio, especifique la ruta completa:

docker compose -f /opt/n8n-traefik/docker-compose.yml logs –f 

Para verificar los logs de un contenedor específico, utiliza los comandos: 

docker logs n8n-main

docker logs postgres

docker logs redis

docker logs traefik

Verificar si Docker está funcionando

En el terminal, para verificar si Docker está en funcionamiento, ejecuta el comando:

systemctl status docker

Si aparece "inactive", inicia con: 

systemctl start docker

Verificar conectividad entre servicios

Si n8n muestra error 502 o no puede conectar a la base de datos: 

- Prueba la conexión con PostgreSQL con el comando: 

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

- Verifica si el container está corriendo con el comando: 

docker ps | grep postgres

- Verifica los logs de postgres con el comando: 

docker logs postgres | tail -20

- Prueba la conexión con Redis con el comando: 

docker exec -it redis redis-cli ping

Debe retornar: PONG 

Si no responde:

- Verifica si está corriendo con el comando:

docker ps | grep redis 

- Verifica los logs con el comando: 

docker logs redis | tail –20

- Reinicia si es necesario con el comando: 

docker restart redis 

Si ambos los servicios están OK, reinicia el n8n con el comando:

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

Descubrir el usuario de la base de datos PostgreSQL 

1  Para verificar las variables de entorno del contenedor PostgreSQL, utiliza: 

docker exec -it postgres env | grep POSTGRES 

Esto mostrará las variables como:

• POSTGRES_USER= (nombre del usuario)
• POSTGRES_PASSWORD=
• POSTGRES_DB=

2 Verifica el docker-compose.yml con el comando:

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

Reiniciar los contenedores

Reinicia los contenedores sin alterar la versión de n8n, cuando ocurren problemas como: 

• n8n no abre vía navegador
• Contenedor congelado
• Error 502 Bad Gateway
• Actualizaciones incompletas
• Consumo alto de memoria por los procesos de Node.js 

Para solucionar, sigue estos pasos: 

1Accede al directorio del proyecto, escribe el comando: 

cd /opt/n8n-traefik/

2Luego, para detener y eliminar los contenedores actuales, escriba el comando:

docker compose down

3  Después, inicia los contenedores nuevamente con la misma configuración (versión actual de n8n) con el comando:

docker compose up -d

4Verifica si se subieron correctamente ejecutando el comando: 

docker ps

Debes visualizar contenedores como:

• n8n-main
• postgres
• redis
• traefik

5Espera 30 segundos y prueba cómo acceder al n8n a través del navegador 

Restaurar workflows (flujos de trabajo)

1Crea el directorio de respaldo dentro del contenedor (si aún no existe) con el comando:

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

2Copia el archivo de respaldo dentro del contenedor con el comando:

docker cp /root/n8n-backup/20250717/workflows.json n8n-main:/home/node/n8n-backup/$(date)/workflows.json

Substituye "root/n8n-backup/20250717/workflows.json" por la ruta real 

3Ahora, importe los workflows:

docker exec -it n8n-main n8n import:workflow --input=/home/node/n8n-backup/$(date)/workflows.json

4Después de esto:

• Los workflows existentes se sobrescribirán con los datos de la copia de seguridad
• Los workflows creados después de la copia de seguridad permanecerán
• Los workflows que han sido eliminados serán recreados

Contenedores que no responden

Si los contenedores en ejecución no están respondiendo o tienen un comportamiento inesperado, puedes verificar los registros para entender qué está sucediendo.

Consulta cómo:

1Lista los contenedores activos, ingresa el comando:

docker ps

Ejemplo de respuesta:

2Utiliza el "CONTAINER ID" en el comando a continuación para consultar los logs:

docker logs container_id 

Substituye el “container_id” por el valor real, por ejemplo: docker logs rgs8n5n9c0bc 

Este comando es útil para identificar fallas específicas de cada servicio (n8n, traefik, banco, etc). 

Limpiar caché de Docker

Ejecuta el comando:  

docker system prune -a –volumes

Limpiar logs del sistema 

Ejecuta el comando:  

journalctl --vacuum-time=7d 

¡Listo! Ahora conoces los medios para identificar y corregir problemas en tu n8n.