Web Interfaces
A comprehensive guide to every browser-based GUI available in the GospeLib local development stack. For a compact port table, see the Port Map.
GospeLib Applications
Web App
| URL | http://localhost:3002 |
| Port | 3002 |
| Framework | Next.js 15 (App Router) |
| Source | apps/web |
The user-facing scripture reader and study environment.
Admin Dashboard
| URL | http://localhost:3001 |
| Port | 3001 |
| Framework | Next.js 15 (App Router) |
| Source | apps/admin |
Internal admin dashboard for content management and user administration.
Docs Site
| URL | http://localhost:3003 |
| Port | 3003 |
| Framework | Docusaurus 3 |
| Source | apps/docs |
| Product Docs | docusaurus.io |
Internal engineering documentation (this site).
API Documentation
Both Python services (Content and AI) expose auto-generated API documentation via FastAPI's built-in support.
Content Service
| Interface | URL |
|---|---|
| Swagger UI | http://localhost:8100/docs |
| ReDoc | http://localhost:8100/redoc |
| OpenAPI JSON | http://localhost:8100/openapi.json |
- Port: 8100
- Source:
services/content - Product Docs: FastAPI docs
AI Service
| Interface | URL |
|---|---|
| Swagger UI | http://localhost:8400/docs |
| ReDoc | http://localhost:8400/redoc |
| OpenAPI JSON | http://localhost:8400/openapi.json |
- Port: 8400
- Source:
services/ai - Product Docs: FastAPI docs
Observability
Grafana
| URL | http://localhost:3000 |
| Port | 3000 |
| Default User | admin |
| Default Password | localdev |
| Product Docs | grafana.com/docs/grafana/latest |
Dashboards and alerting for all services. Pre-configured with Prometheus and Loki datasources. Default credentials are set via the GF_SECURITY_ADMIN_PASSWORD environment variable in compose.dev.yml.
Grafana Alloy UI
| URL | http://localhost:12345 |
| Port | 12345 |
| Product Docs | grafana.com/docs/alloy/latest |
Grafana Alloy's built-in debugging UI. Shows component graph, live pipeline status, and clustering state. Useful for debugging telemetry collection issues.
The Alloy container binds its HTTP server to 0.0.0.0:12345 via the --server.http.listen-addr flag in compose.dev.yml. Without this flag, Alloy defaults to 127.0.0.1, which is unreachable from outside the container.
Data Store GUIs
FalkorDB Browser
| URL | http://localhost:3004 |
| Port | 3004 |
| Product Docs | docs.falkordb.com |
Web-based browser for the FalkorDB graph database. Visualize nodes, relationships, and run Cypher queries directly.
RedisInsight
| URL | http://localhost:5540 |
| Port | 5540 |
| Product Docs | redis.io/docs/connect/insight |
Redis GUI for browsing keys, running commands, and monitoring the Redis instance (port 6380). Also useful for inspecting FalkorDB's underlying Redis data (port 6379).
Data Stores Without Built-in Web UI
These data stores are accessible only via their native protocols or CLI tools. Optional third-party GUIs are listed for convenience.
| Store | Port | Protocol | Optional GUI |
|---|---|---|---|
| FalkorDB | 6379 | Redis protocol | FalkorDB Browser (included, port 3004) |
| PostgreSQL | 5432 | PostgreSQL wire protocol | pgAdmin, DBeaver |
| Redis | 6380 | Redis protocol | RedisInsight (included, port 5540) |
| Typesense | 8108 | HTTP REST API | Typesense Dashboard |
FalkorDB (port 6379) and general-purpose Redis (port 6380) are separate instances. Do not confuse them. FalkorDB uses the Redis wire protocol but stores graph data.
Go Service Health Endpoints
The four Go services expose health endpoints but no browser GUI:
| Service | Health URL |
|---|---|
| Gateway | http://localhost:8080/health |
| Auth | http://localhost:8200/health |
| Billing | http://localhost:8300/health |
| Notifications | http://localhost:8500/health |
These return JSON and are useful for quick verification that services are running.