Durante el uso de n8n, como actualizaciones, importaciones o errores de ejecución, puede ser necesario realizar algunos ajustes directamente en el terminal del servidor a través de SSH.

En este artículo, usted encontrará comandos esenciales para diagnosticar y resolver problemas comunes en el entorno Docker Compose de n8n.

Revise algunos comandos:

• Verificar logs
• Reiniciar los contenedores
• Restaurar workflows (flujos de trabajo) a partir de una copia de seguridad
• Contenedores que no responden

Verificar logs

Si está en el directorio donde se encuentra el archivo docker-compose.yml, use:

docker compose logs -f 

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

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

Reiniciar los contenedores

Para reiniciar los contenedores (sin alterar la versión), use:

• Detener los contenedores actuales, escriba:

  docker compose down

• Después, para especificar la versión anterior en el docker-compose.yml, escriba:

  docker compose up -d

Restaurar workflows (flujos de trabajo) a partir de una copia de seguridad

1Creé el directorio de copia de seguridad dentro del contenedor (en caso de que aún no exista):

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

2Copie el archivo de respaldo dentro del contenedor:

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

Reemplace "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 serán sustituidos 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, usted puede verificar los registros para entender qué está sucediendo.

Considere cómo:

1Primero usted necesita obtener el container-id, para eso, escriba el comando:

docker ps

Ejemplo de respuesta:

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

docker logs container_id 

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