Errores comunes
Mensajes de error frecuentes en Web Hosting y cómo resolverlos.
"Se detectó un archivo Compose en el repositorio/paquete"
El panel rechaza cualquier docker-compose.yml / compose.yml en tu
código. Elimina el archivo del repositorio (o de lo que subas) y vuelve a
intentar el despliegue: la plataforma construye y ejecuta tu aplicación
solo a partir de tu Dockerfile.
"Motor de base de datos no permitido"
Intentaste aprovisionar un motor que tu instancia no tiene habilitado (por
ejemplo, pediste postgres pero solo mysql está permitido). Revisa con
el operador de tu instancia qué motores están disponibles.
"Ya existe una base de datos para esta instancia; elimina la actual primero"
Cada instancia solo admite una base de datos administrada a la vez. Si quieres cambiar de motor, primero debes eliminarla (Deprovision) desde la pestaña Base de datos.
"No hay base de datos aprovisionada"
Intentaste respaldar, restaurar o rotar credenciales sin haber aprovisionado una base de datos todavía. Aprovisiona una primero.
"Nombre de archivo de respaldo inválido"
Ocurre si el nombre del archivo de respaldo con el que intentas restaurar está corrupto o fue manipulado. Usa siempre la lista de respaldos que muestra el propio panel, no escribas el nombre a mano.
Mi aplicación no arranca después de desplegar
- Revisa Consola para ver la salida/errores de tu aplicación.
- Confirma que tu
Dockerfileescucha en el puerto deAPP_PORT(no un puerto fijo tuyo). - Recuerda que el contenedor final es de solo lectura (
read_only): si tu app escribe archivos fuera del volumen de datos persistente o de/tmp, fallará al iniciar. - Como el despliegue solo corta tráfico después del chequeo de salud, tu versión anterior sigue respondiendo mientras solucionas el problema.
Estoy bloqueado por límite de solicitudes ("rate limit")
Algunas acciones sensibles (aprovisionar base de datos, rotar credenciales, respaldar/restaurar) tienen un límite de operaciones por hora para evitar errores en cascada. Espera unos minutos y vuelve a intentar.