---
title: "Uso de la imagen Docker"
description: "Uso completo de la imagen Docker"
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-08-27"
last_update: "2026-08-27"
time_minutes: 3
draft: false
unlisted: false
url: "https://core.libredte.cl/docs/docker-api/uso"
---

# 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:

```shell
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:

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

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

```shell
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`:

```shell
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
```

> [!NOTE] Nota
>
> Esto asume que el propio Docker arranca al iniciar el host: en
> Docker Desktop necesitas tener activado "iniciar Docker Desktop al
> iniciar sesión"; en Linux con systemd, `dockerd` normalmente ya
> arranca solo.

## `docker compose`

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

```shell
git clone git@github.com: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:

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

## Construir la imagen localmente

En vez de usar la publicada en GHCR:

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



---
Last updated on 27/08/2026