SEA™ Development Access Points

Quick reference for all service endpoints, ports, and URLs in local development.

Quick Start

1
2
3
4
5
# Start all services
just dev-up

# Check service status
docker ps | grep sea

Services

Knowledge Graph Service

Endpoint URL
API Docs http://localhost:8010/docs
Health http://localhost:8010/health
SPARQL POST http://localhost:8010/kg/sparql
Projection POST http://localhost:8010/kg/projection
Stats http://localhost:8010/kg/stats

PostgreSQL

Property Value
Host localhost
Port 5432
Database sea_dev
User sea
Password seadev
Connection String postgresql://sea:seadev@localhost:5432/sea_dev

Redis

Property Value
Host localhost
Port 6379
Connection redis://localhost:6379

NATS JetStream

Endpoint URL
Client nats://localhost:4222
Monitoring http://localhost:8222
Health http://localhost:8222/healthz
Streaming http://localhost:8222/streaming

OpenTelemetry Collector

Endpoint URL
OTLP gRPC localhost:4317
OTLP HTTP http://localhost:4318
Metrics http://localhost:8888/metrics
Health http://localhost:13133
zPages Traces http://localhost:55679/debug/tracez
zPages Spans http://localhost:55679/debug/spanperz

Environment Variables

Override default ports via .env or shell:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# Ports
POSTGRES_PORT=5432
REDIS_PORT=6379
NATS_PORT=4222
NATS_HTTP_PORT=8222
KG_PORT=8010
OTEL_GRPC_PORT=4317
OTEL_HTTP_PORT=4318
OTEL_METRICS_PORT=8888

# PostgreSQL
POSTGRES_USER=sea
POSTGRES_PASSWORD=seadev
POSTGRES_DB=sea_dev

# Logging
LOG_LEVEL=INFO

Container Names

Container Service
sea-postgres PostgreSQL 16
sea-redis Redis 7
sea-nats NATS JetStream 2.10
sea-otel-collector OTel Collector 0.142.0
sea-knowledge-graph Knowledge Graph API

Health Checks

1
2
3
4
5
6
# All services
curl http://localhost:8010/health   # Knowledge Graph
curl http://localhost:13133         # OTel Collector
curl http://localhost:8222/healthz  # NATS
redis-cli ping                      # Redis
pg_isready -h localhost -U sea      # PostgreSQL

Commands

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# Start services
just dev-up

# Stop services
just dev-down

# Reset (remove volumes)
just dev-reset

# View logs
docker logs sea-knowledge-graph
docker logs sea-otel-collector

# Restart single service
docker restart sea-knowledge-graph