Saltar al contenido
SeedemGuía de despliegues

Solución de problemas

Paso 6: Errores comunes al desplegar

Paso 6 de 7

Si el despliegue falla en Coolify, el estado queda en Failed y el log del despliegue muestra el motivo. Estos son los errores más comunes y cómo resolverlos.

Falta el Dockerfile (no such file or directory)

El log muestra un error como "open Dockerfile: no such file or directory". Significa que los archivos de configuración no están en el repositorio remoto.

  1. Verifica que creaste los archivos del paso Configurar los archivos de despliegue (Dockerfile, server-node.mjs y el cambio en vite.config.ts).
  2. Revisa con git status que no queden cambios sin subir.
  3. Haz git add, git commit y git push, y lanza el despliegue de nuevo.
Log de un despliegue fallido en Coolify mostrando el error "open Dockerfile: no such file or directory"
Este error indica que el Dockerfile no estaba en el repositorio al momento de desplegar.

No conecta el repositorio (llave SSH)

Si Coolify no logra clonar el repositorio, casi siempre es un problema de la llave SSH: no está registrada en Coolify o no tiene permiso sobre el repositorio de GitHub.

  • Verifica que tu llave aparezca registrada en Coolify (Manage → "Keys & Tokens").
  • Verifica que esa llave esté autorizada en la organización seedemco de GitHub.

Sin espacio en el servidor (no space left on device)

El log muestra "no space left on device" mientras copia archivos durante el build.

Log de un despliegue fallido mostrando el error "no space left on device"
El error "no space left on device" indica que el servidor se quedó sin espacio en disco.

Falla npm ci (falta package-lock.json)

El build falla en la línea "RUN npm ci" del Dockerfile con un error como "did not complete successfully: exit code 1". Suele ocurrir porque el archivo package-lock.json no está en el repositorio (no se generó o no se subió).

Log de un despliegue fallido mostrando el error en la línea "RUN npm ci" del Dockerfile
Si falla en "RUN npm ci", revisa que package-lock.json exista en el repositorio.
  1. En tu copia local, ejecuta npm i dentro de la carpeta del proyecto para generar el package-lock.json.
  2. Sube el archivo nuevo al repositorio.
  3. Lanza el despliegue de nuevo desde Coolify.
terminal
npm i
git add .
git commit -m "Add package-lock"
git push

Las imágenes no cargan en la página publicada

Si el despliegue termina en Success pero al abrir la página las imágenes no cargan (aparecen rotas o vacías), casi siempre es por los archivos .asset.json que Lovable genera en la carpeta src/assets: su campo url no tiene el dominio completo de las imágenes.

Archivo .asset.json en src/assets con el campo url señalado
Si el campo "url" no lleva el dominio completo, las imágenes no cargan en el despliegue.
  1. Abre cada archivo .asset.json dentro de src/assets y completa el campo url con el dominio de las imágenes, como se explica en el paso Configurar los archivos de despliegue.
  2. Sube los cambios al repositorio con git add, git commit y git push.
  3. Lanza el despliegue de nuevo desde Coolify.