Solución de problemas

Dónde mirar primero

# systemd status
sudo systemctl status pier

# logs (last 100 lines)
sudo journalctl -u pier -n 100 --no-pager

# live tail
sudo journalctl -u pier -f

Síntomas comunes

”Port 80 already in use”

Otro servicio (Apache, nginx, un Traefik distinto) está ocupando el puerto 80 en el host. Deténlo o muévelo. Pier espera que Traefik sea el dueño del 80 y el 443.

Let’s Encrypt no logra emitir un certificado

• El registro A del dominio debe resolver a este servidor antes de que añadas el dominio en Pier.
• El puerto 80 debe estar abierto a la internet pública — los desafíos ACME HTTP-01 lo necesitan.
• Revisa los logs de Traefik: docker logs pier-traefik.

El contenedor arranca y luego se cierra de inmediato

• Abre la pestaña Logs del servicio. La mayoría de los problemas de imagen aparecen en el stdout del contenedor.
• Confirma que las variables de entorno están definidas. La falta de una variable de entorno requerida es la causa más común.
• Para bases de datos, comprueba el espacio en disco del volumen de datos: df -h.

El panel muestra 502

• Probablemente la unidad systemd de Pier no esté en ejecución. sudo systemctl restart pier.
• Si Pier está en ejecución pero devuelve 502, revisa journalctl -u pier -n 200 en busca de panics.

Uso elevado de memoria

Un único proceso de Pier debería mantenerse por debajo de 50 MB residentes. Si ves cientos de MB, uno de los contenedores gestionados los está usando. Abre el popup de Memory en el panel — desglosa la memoria por contenedor.

Reportar errores

Abre incidencias en el repositorio de Pier con:

• Versión de Pier (Settings → Updates).
• SO + versión de Docker.
• 100 líneas de journalctl -u pier.
• Pasos para reproducir.