Instalar AI Gateway

Ejecuta el gateway con Postgres y Redis. El repositorio incluye un stack de Docker Compose para desarrollo local, servidores Linux, Coolify, Portainer y Dokploy. El dashboard es un servicio independiente.

Elige tu plataforma

• Desarrollo local: ejecútelo en su máquina para el desarrollo.
• Coolify: implementa la stack de Compose en Coolify.
• Portainer: implementa la stack de Compose en Portainer.
• Dokploy: implementa la stack de Compose en Dokploy.
• Docker en un servidor Linux: docker compose simple en cualquier host.

Topologías

La conexión del gateway con Postgres y Redis determina si necesitas TLS. Como el gateway se ejecuta en Bun, los certificados autofirmados pueden causar el problema de TLS descrito aquí.

Las guías usan por defecto la primera topología: el gateway se comunica con Postgres y Redis a través de la red privada de Compose, sin TLS. El aislamiento de red restringe el acceso y evita el problema de certificados de Bun.

Archivos de Compose

• docker/compose.yaml es la base de producción. Expone servicios a la red privada sin publicar puertos de host.
• docker/compose.local.yaml agrega asignaciones de host de solo loopback para desarrollo local o un proxy inverso de host. Cárguelo explícitamente; no lo agrega a un deployment de PaaS de producción.

Servicios del stack

El repositorio incluye un docker/compose.yaml que muestra toda el stack:

• postgres (postgres:18-alpine) y redis (redis:8-alpine), con comprobaciones de estado y volúmenes con nombre (pgdata, redisdata).
• migrate: ejecuta las migraciones SQL y finaliza; el gateway espera a que termine. Si el panel de la PaaS ofrece asignarle un dominio, deja ese campo vacío.
• gateway (:4000 internamente): construido a partir de apps/api/Dockerfile.
• dashboard (:3001 internamente): interfaz opcional para operadores, desactivada salvo que DASH_ENABLED sea verdadero. Tiene su propio dominio y se conecta al gateway mediante GATEWAY_URL. El gateway no necesita configuración adicional ni tiene que ser público. Consulta Dashboard → Servicio.

Coolify y Dokploy usan solo docker/compose.yaml y conectan su proxy a la red privada. Para desarrollo local o un reverse proxy en el host, añade explícitamente el archivo de configuración local:

git clone https://github.com/boelabs/ai-gateway.git && cd ai-gateway

MASTER_KEY=$(openssl rand -base64 48) \
ENCRYPTION_KEY_HEX=$(openssl rand -hex 32) \
docker compose -f docker/compose.yaml -f docker/compose.local.yaml up -d

docker/compose.local.yaml proporciona valores conocidos solo para desarrollo. La configuración de producción deja ambos secretos vacíos: el gateway no arranca hasta que los configures. En Coolify, Portainer o Dokploy, introdúcelos en la interfaz. Por defecto, DATABASE_URL y REDIS_URL apuntan a los servicios internos postgres/redis sin TLS; cámbialos si usas instancias administradas. Consulta Configuración inicial.