Uso de la imagen Docker

El contenedor siempre escucha internamente en el puerto 80 (fijo, no se configura). El puerto externo lo eliges tú al mapearlo con -p, sin ninguna relación con el interno.

APP_URL es aparte: es la URL que la propia API usa para armar enlaces absolutos en sus respuestas (HATEOAS, spec de OpenAPI, etc.), y debería apuntar al puerto externo que elegiste para que esos enlaces sean correctos. Si no la configuras, o no coincide con el puerto externo real, la API igual funciona — solo los enlaces que devuelve quedarán con la URL por defecto.

docker run, con la imagen ya publicada

Corriendo directo la imagen publicada en GHCR, en segundo plano:

docker run -d --rm \
    --name libredte-lib-core-api \
    -p 8080:80 \
    -e APP_URL=http://localhost:8080 \
    ghcr.io/libredte/libredte-lib-core-api:latest

-d lo deja corriendo en segundo plano (sin -d se queda en primer plano y Ctrl+C lo detiene). --rm hace que el contenedor se borre solo cuando lo detengas, en vez de quedar acumulado como “Exited”. Para ver los logs o detenerlo:

docker logs -f libredte-lib-core-api
docker stop libredte-lib-core-api

Para usar otro puerto externo (ej. 9090), cambia ambos valores:

docker run -d --rm \
    --name libredte-lib-core-api \
    -p 9090:80 \
    -e APP_URL=http://localhost:9090 \
    ghcr.io/libredte/libredte-lib-core-api:latest

Los ejemplos anteriores usan --rm: cómodo para probar, pero no vuelve a levantarse solo si reinicias el host (--restart y --rm son mutuamente excluyentes en Docker). Para un servicio persistente que sobreviva reinicios, saca --rm y usa --restart unless-stopped:

docker run -d --restart unless-stopped \
    --name libredte-lib-core-api \
    -p 8080:80 \
    -e APP_URL=http://localhost:8080 \
    ghcr.io/libredte/libredte-lib-core-api:latest

docker compose

Clonando el repositorio, docker compose baja la imagen ya publicada (no la reconstruye) mientras no le pidas --build:

git clone [email protected]:LibreDTE/libredte-lib-core-api.git
cd libredte-lib-core-api
docker compose up -d

(sin -d también queda en primer plano; con -d corre en segundo plano y docker compose logs -f / docker compose down sirven para verlo o detenerlo).

docker-compose.yml expone dos variables de entorno independientes, cada una con su propio default (8080 para ambas, pero no están ligadas entre sí):

• PORT: el puerto externo publicado en el host (el interno del contenedor siempre es 80).
• APP_URL: la URL que la API usa para armar sus enlaces.

Para usar otro puerto:

PORT=9090 APP_URL=http://localhost:9090 docker compose up -d

Construir la imagen localmente

En vez de usar la publicada en GHCR:

docker build -t libredte-lib-core-api .