diff --git a/docs/coolify.md b/docs/coolify.md
index 23074c6..b9414e7 100644
--- a/docs/coolify.md
+++ b/docs/coolify.md
@@ -94,6 +94,16 @@ En Coolify el servicio de PANELS se llama **`web-panel`** (FQDN ej. `panels.mrde
 10. Login SaaS `admin` / tu `SEED_PASSWORD` (tras el bootstrap).
 11. SMTP en `/smtp` o por `SMTP_*`.
 
+## Troubleshooting: `UnknownHostException` / Liquibase no conecta
+
+El host de las 6 `DATABASE_URL_*` y de las 2 `REDIS_URL_*` **no** es el ID corto del contenedor (`docker exec -it c72dde7d6b47 …`). Docker DNS en Coolify **no** resuelve ese ID; Liquibase falla con `UnknownHostException`.
+
+Usa el hostname de **Postgres URL (internal)** / **Redis URL (internal)** en Coolify: el segmento entre `@` y `:5432` (o `:6379`). Suele ser un UUID o el nombre de servicio de Coolify, no los 12 caracteres del `CONTAINER ID`.
+
+Además, el recurso Docker Compose de PANELS debe estar en la **misma red** que Postgres y Redis (Connect to Predefined Network, a menudo `coolify`). Si no, el hostname interno existe pero el contenedor `migrate` no lo ve.
+
+Tras corregir las URLs, redesplegar y revisar `docker logs` del contenedor `migrate-*` (debe terminar con Liquibase `Update has been successful` o similar, exit 0). El `docker stop … No such container` del helper de Coolify es ruido de limpieza, no la causa.
+
 ## Local (todo en docker-compose, incluyendo Postgres/Redis propios)
 
 ```bash