64 docs indexed
All three obleth listeners, Docker Compose host port mappings, Kubernetes service ports, and HAProxy frontend.
| Listener | Bind address | Purpose |
|---|---|---|
| Data plane | 0.0.0.0:8080 | OpenAI-compatible proxy for client requests |
| Management API | 0.0.0.0:9180 | Admin REST API for all configuration |
| Prometheus metrics | 0.0.0.0:9091 | Prometheus scrape endpoint |
| Service | Container port | Host port | Purpose |
|---|---|---|---|
obleth data plane | 8080 | 8088 | Access via HAProxy on port 80 (edge profile) |
obleth admin | 9180 | 9180 | Management API |
obleth metrics | 9091 | 9091 | Prometheus scrape |
control-plane | 3000 | 3002 | Dashboard |
postgres | 5432 | 5432 | Database |
redis | 6379 | 6379 | Cache |
clickhouse HTTP | 8123 | 8123 | ClickHouse HTTP API |
clickhouse native | 9000 | 9000 | ClickHouse native protocol |
benchmark-backend | 8081 | 8081 | Benchmark fixture backend (benchmark profile) |
haproxy | 80 | 80 | TLS-optional edge proxy (edge profile) |
prometheus | 9090 | 9090 | Prometheus UI (observability profile) |
grafana | 3000 | 3001 | Grafana UI (observability profile) |
jaeger | 16686 | 16686 | Jaeger trace UI (observability profile) |
| Service | Port | Type |
|---|---|---|
obleth data plane | 8080 | ClusterIP |
obleth admin | 9180 | ClusterIP (internal only) |
obleth metrics | 9091 | ClusterIP |
control-plane | 3000 | ClusterIP (exposed via Ingress if enabled) |
When running the Docker Compose edge profile or the Helm HAProxy chart:
| Port | Protocol | Backend |
|---|---|---|
80 | HTTP | obleth data plane (8080) |
443 | HTTPS (TLS) | obleth data plane (8080) |
HAProxy does round-robin across all obleth pod IPs. Add TLS by mounting certificates at /etc/ssl/certs/obleth.pem in the HAProxy container.
# Management API health
curl http://localhost:9180/api/v1/health
# Data plane liveness (no auth required)
curl http://localhost/health # via HAProxy (edge profile)
# curl http://localhost:8088/health # direct host port in Docker Compose
# curl http://localhost:8080/health # native cargo run (binds :8080 on the host)
# Metrics
curl http://localhost:9091/metrics | head -20
The data plane's /v1/models route requires a tenant API key. Use /health for a
liveness probe instead.