Errores de los contenedores
Soluciones para cuando los contenedores Docker del facturador o del proxy no arrancan bien.
Cuándo usarla
- Al ejecutar
docker ps, el proxy aparece en estado Restarting (reiniciando) y no pasa a Up. - El facturador no carga en el navegador y alguno de sus contenedores (
fpm,nginx,mariadb,redis,supervisor,scheduling) no está en estado Up.
Antes de empezar
-
Acceso SSH como
root(Conexión remota). -
Revise el estado de todos los contenedores:
docker ps -a
El proxy se queda reiniciando
Pasa a veces después de docker restart proxy-proxy-1. Un restart no basta: hay que bajar el proxy y volver a levantarlo.
-
Entre a la carpeta del proxy:
cd /root/proxy -
Baje y levante el proxy:
docker compose down docker compose up -d
Nota
Mientras el proxy está abajo, ningún facturador del servidor responde. Son unos segundos, pero conviene hacerlo fuera del horario de mayor uso.
Reiniciar los contenedores del facturador
-
Entre a la carpeta del facturador (la que muestra
cat [su dominio].txtcomo Ruta del proyecto):cd /ruta/del/facturador -
Baje los contenedores:
docker compose down -
Vuelva a levantarlos:
docker compose up -d
docker compose down detiene y elimina los contenedores, pero no borra la base de datos ni los archivos: viven en volúmenes y carpetas que se conservan. No agregue la opción -v, porque esa sí elimina los volúmenes.
Cómo verificar
docker ps
Todos los contenedores deben estar en estado Up. Después abra el facturador en el navegador e inicie sesión.
Si algo sale mal
| Síntoma | Qué hacer |
|---|---|
| Un contenedor sigue en Restarting o Exited | Revise su log con docker logs --tail 100 [nombre_contenedor]; el error suele estar en las últimas líneas. |
| port is already allocated al levantar | Otro servicio usa el puerto (Apache, Nginx o MySQL instalados en el servidor). Deténgalo, por ejemplo con systemctl stop apache2, y vuelva a levantar. |
| network proxynet not found | Cree la red y vuelva a levantar: docker network create proxynet. |
| No space left on device | El disco o los inodes están llenos: Incrementar espacio en disco o Limpieza de inodes. |