$ OpenGSLB

DNS-first global load balancing.
Not a service mesh. Not a proxy. Just intelligent DNS.

Enterprise GSLB without the enterprise tax

Why OpenGSLB?

Feature F5 GTM NetScaler Route53 Cloudflare Consul OpenGSLB
Self-hosted / Data sovereignty
No vendor lock-in
Geolocation routing
Latency / RTT-based routing
EDNS Client Subnet (ECS)
Weighted failover chains
Predictive health checks
Agent-side failure prediction
External health validation
DNSSEC support
Server management API
Gossip-based state sync N/A N/A
Open source
Annual cost $50K-$250K $20K-$100K+ Pay/query $200+/mo Free Free
Setup complexity High High Low Low Medium Low

Agent-Overwatch Architecture

OpenGSLB uses a simplified two-component architecture. Agents run alongside your applications, monitoring local health and gossiping state to Overwatch nodes. Overwatches serve authoritative DNS and independently validate agent claims—no complex consensus protocols, no VIP management, just DNS client retry for redundancy.

OpenGSLB Agent-Overwatch Architecture - Agents gossip to independent Overwatch nodes that serve DNS

Agents gossip to all Overwatch nodes • Each Overwatch operates independently • DNS clients retry on failure

Security First MANDATORY

Unlike other solutions where security is optional, OpenGSLB enforces security by default with no opt-out for critical features.

Mandatory Gossip Encryption

All agent-to-overwatch communication uses AES-256 encryption. There is no "disable encryption" option—OpenGSLB won't start without a valid encryption key.

TOFU Certificate Pinning

Agents authenticate using service tokens on first connection, then certificates are pinned. Prevents impersonation attacks even if tokens are compromised later.

DNSSEC Support

DNSSEC signing with NSEC3 to prevent zone enumeration. Includes automatic key generation, inter-Overwatch key synchronization, and configurable algorithms.

Health Authority Hierarchy

Four-level trust model: Agent claims → Overwatch validation → External tools → Human override. Overwatch external checks always win over agent claims.

IP-Based Access Control

API and metrics endpoints secured via IP allowlists by default. Localhost-only access unless explicitly configured for network access.

Audit Logging

All override changes, certificate pins, and administrative actions are logged with timestamps and source identification for compliance requirements.

Built for Production

DNS Authoritative Server

Full DNS implementation with A/AAAA records, UDP+TCP transport, configurable TTLs, NXDOMAIN handling, and DNSSEC signing.

Smart Routing Algorithms

Round-robin, weighted distribution, active/standby failover, geolocation routing with custom CIDR mappings, and latency-based routing with EMA smoothing.

EDNS Client Subnet (ECS)New

Extract client location from recursive resolvers for accurate geo-routing even when clients use public DNS services like Google or Cloudflare.

Predictive Health Checks

Agent-side failure prediction monitors CPU, memory, and error rates. Detects degradation before it impacts DNS responses—something no SaaS GSLB offers.

Unified Server Architecture

Three server sources unified into one: static configuration, agent registration, and API registration. All participate equally in routing decisions.

Server Management API

Full CRUD API for dynamic server management. Add, update, or remove servers at runtime without configuration changes or restarts.

Dynamic DNS Registration

Servers registered via API or agents automatically participate in DNS routing based on their service associations. No manual domain configuration needed.

Dual-Perspective Validation

Agents know they're about to fail (predictive). Overwatches validate claims independently (reactive). Both perspectives combined eliminate false positives.

Observability First

Structured logging (JSON/text), Prometheus metrics, health status API, CLI management tool. Hot-reload configuration via SIGHUP without downtime.

Multi-File Configuration

Split configuration across multiple files with glob patterns, environment variable expansion, and layered merging for team-based management.

CLI Management Tool

Full-featured opengslb-cli for status monitoring, server management, override control, geo testing, DNSSEC management, and config validation.

Zero External Dependencies

Single Go binary. No external databases, no service mesh, no Kubernetes required. Deploy via Docker, systemd, or bare metal. Works on Linux and Windows.

Run in 30 Seconds

Overwatch Node (serves DNS)
# Pull and run as Overwatch docker run -d \ -p 53:53/udp -p 53:53/tcp -p 9090:9090 \ -v ./overwatch.yaml:/config.yaml \ ghcr.io/loganrossus/opengslb:latest \ --mode=overwatch --config /config.yaml # Or build from source git clone https://github.com/LoganRossUS/OpenGSLB.git cd OpenGSLB && go build -o opengslb ./cmd/opengslb ./opengslb --mode=overwatch --config config/overwatch-example.yaml
Agent (runs alongside your app)
# Run agent on application servers ./opengslb --mode=agent --config agent.yaml # Agent config registers backends and gossips to Overwatches # Multiple backends per agent supported
Dynamic Server Registration via API
# Register a server dynamically curl -X POST http://localhost:9090/api/v1/servers \ -H "Content-Type: application/json" \ -d '{ "address": "10.0.1.50", "port": 80, "service": "app.example.com", "weight": 100, "region": "us-east" }' # Server immediately participates in DNS routing!

Development Roadmap

Nov 2025
Sprint 1-2: Foundation
  • CI/CD pipelines & Docker builds
  • DNS server (A/AAAA, UDP/TCP)
  • HTTP health checks
  • Round-robin routing
  • Prometheus metrics & logging
Dec 2025
Sprint 3-4: Advanced Routing
  • Weighted & failover routing
  • TCP health checks
  • Config hot-reload (SIGHUP)
  • Health status API
  • Agent-Overwatch architecture
Dec 2025
Sprint 5: Security
  • Mandatory gossip encryption
  • TOFU certificate pinning
  • DNSSEC with NSEC3
  • External override API
  • Multi-backend agents
Dec 2025
Sprint 6: Intelligence
  • Geolocation routing (GeoIP)
  • Custom CIDR mappings
  • Latency-based routing (EMA)
  • EDNS Client Subnet (ECS)
  • CLI management tool
Dec 2025
v1.1.9: Stable Release
  • Unified server architecture
  • Server management CRUD API
  • Dynamic DNS registration
  • API/agent server parity
  • Enhanced operational runbooks
Q1 2026 (Next)
Sprint 7-8: Overlord
  • Centralized web dashboard
  • Historical data & trends
  • Alerting & notifications
  • Multi-Overwatch aggregation
  • Grafana dashboard templates
Future
Advanced Features
  • DNS-over-HTTPS/TLS
  • Dynamic service registration
  • Rate limiting & DDoS protection
  • Kubernetes operator
  • Terraform provider