Documentation

Comprehensive guides covering installation, configuration, API reference, and operational best practices.

Read the Docs

GitHub Issues

Report bugs, request features, or browse existing issues. Our primary channel for community support.

Open an Issue

Discussions

Ask questions, share ideas, and connect with other OpenGSLB users in GitHub Discussions.

Join Discussion

Discord

Join our Discord server for real-time chat, quick questions, and community discussions.

Join Discord

Reddit

Follow r/OpenGSLB for announcements, tutorials, and community discussions on Reddit.

Visit Subreddit

Configuration Guide

Complete configuration reference with examples for every routing algorithm and deployment scenario.

View Config Docs

Interactive Demos

Hands-on tutorials from basic DNS load balancing to advanced latency-based routing.

Try Demos

Commercial License

Need to use OpenGSLB in a proprietary product or appliance? Contact us for commercial licensing.

Contact Sales

Frequently Asked Questions

Is OpenGSLB production-ready?
Yes! OpenGSLB v1.1.9 includes all core GSLB features: multiple routing algorithms, health checks with predictive failure detection, DNSSEC, and the agent-overwatch architecture for distributed deployments. It's been designed with production use cases in mind from the start.
Can I use OpenGSLB for free?
Absolutely! OpenGSLB is free under AGPLv3 for open-source projects, internal use, and anyone willing to share their modifications. If you're building a proprietary product or appliance, you'll need a commercial license.
What's the difference between Agent and Overwatch modes?
Agents run alongside your application servers, performing local health checks and gossiping status to Overwatches. Overwatches serve authoritative DNS, maintain the backend registry, and independently validate agent claims. This dual-perspective approach eliminates false positives.
Do I need a GeoIP database for geolocation routing?
OpenGSLB supports MaxMind GeoIP2/GeoLite2 databases for geographic routing. You can use the free GeoLite2 database or purchase a commercial GeoIP2 database for higher accuracy. You can also define custom CIDR-to-region mappings for known IP ranges.
How do I update OpenGSLB without downtime?
OpenGSLB supports configuration hot-reload via SIGHUP—no restart required for config changes. For binary updates, deploy multiple Overwatch nodes and update them one at a time. DNS clients automatically retry on failure, ensuring zero downtime.
Does OpenGSLB work with Kubernetes?
Yes, OpenGSLB can be deployed in Kubernetes using our Docker images. A native Kubernetes operator with CRDs is on the roadmap for future releases. Currently, you can use the Server Management API for dynamic service registration.

Support the Project

OpenGSLB is developed and maintained by Logan Ross. If you find it useful, consider buying me a coffee to support continued development!

Buy Me a Coffee