Technology moves fast! ⚡ Don't get left behind.🚶 Subscribe to our mailing list to keep up with latest and greatest in open source projects! 🏆

Subscribe to our mailing list


Load balancer API

Subscribe to updates I use Baragon

Statistics on Baragon

Number of watchers on Github 88
Number of open issues 1
Average time to close an issue 9 days
Main language Java
Average time to merge a PR 4 days
Open pull requests 10+
Closed pull requests 11+
Last commit over 1 year ago
Repo Created over 5 years ago
Repo Last Updated over 1 year ago
Size 8.31 MB
Organization / Authorhubspot
Latest ReleaseBaragon-0.6.2
Page Updated
Do you use Baragon? Leave a review!
View Baragon activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating Baragon for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Baragon Build Status

Behold the mighty Baragon's roar

Baragon is a system for automating load balancer configuration updates. It pairs well with the Singularity Mesos framework.


Baragon Basics

Baragon is made up of two services:

  • BaragonService -- coordination service

  • BaragonAgentService -- applies changes on the actual load balancer

When a web service changes (i.e. upstreams added / removed), POST a BaragonRequest JSON object to BaragonService's /[contextPath]/request endpoint like this one:

  "loadBalancerRequestId": "4",
  "loadBalancerService": {
    "serviceId": "1",
    "owners": ["foo"],
    "serviceBasePath": "/basepath",
    "loadBalancerGroups": ["loadBalancerGroupName"]
  "addUpstreams": [""],
  "removeUpstreams": []
  • BaragonService will fan out the update to all BaragonAgents in the specified loadBalancerGroups
  • BaragonAgents will apply the changes on the load balancer using templates provided in its configuration and report back a Success or Failure to BaragonService
  • Polling the BaragonService request status url (/[contextPath]/request/{loadBalancerRequestId}) will indicate the current status of the request

Check out the API Docs for additional BaragonRequest fields and returned values.

Getting Started

For more details on configuring and using Baragon, check out the detailed setup and management guide

** Prerequisite: A working ZooKeeper cluster **

  1. Build JARs via mvn clean package.

  2. Create a configuration file for Baragon Service and Baragon Agent. These are an extended version of a Dropwizard configuration file. Details on configurable fields can be found in the example configs below and in the detailed setup and management guide

  3. Copy BaragonService-*-SNAPSHOT.jar and $SERVICE_CONFIG_YAML onto one or more hosts, and start the service via java -jar BaragonService-*-SNAPSHOT.jar server $SERVICE_CONFIG_YAML.

  4. Copy BaragonAgentService-*-SNAPSHOT.jar and $AGENT_CONFIG_YAML onto each of your load balancer hosts. Start the BaragonAgent service via java -jar BaragonAgentService-*-SNAPSHOT.jar server $AGENT_CONFIG_YAML.

Quickstart with Docker Compose

To get an example cluster up and running, you can install docker and docker-compose.

Simply run docker-compose up to bring up:

  • zookeper container
  • Baragon Service container
  • Two Baragon Agent + Nginx containers

The Baragon UI will be available at localhost:8080 and nginx at localhost:80.

If using boot2docker replace localhost with the boot2docker ip

Nginx's config directories that BaragonAgent writes to will also be mounted as volumes in the docker/configs folder on your local machine.


Baragon comes with a UI for visualization and easier management of load balancer paths and upstreams. By default it will be available in a read-only mode at /[contextPath]/ui see the Example Baragon Service Configuration or detailed setup and management guide for more details on configuring BaragonUI behavior.

Baragon API Docs

Full documentation on the Baragon Service API can be found here

Baragon open issues Ask a question     (View All Issues)
  • over 3 years Proposal: Kind of colocation
  • over 3 years Proposal: Add support for dynamic ELB listeners configuration
Baragon open pull requests (View All Pulls)
  • #155 - ELB listeners sync support
  • Priorities
  • Add support for specifying aws endpoint or region for elb sync
  • add noServiceUpdate field, for not updating the service when applying a request
  • lock down deps for ui build
  • fix start script
  • Shorter BaragonResponse message
  • Upgrade base pom 15.3 -> 15.7
  • [WIP] Flesh out v2 LoadBalancer
  • (WIP) Support for ELB v2 API - Application Load Balancers
Baragon list of languages used
Baragon latest release notes
Baragon-0.6.2 Baragon 0.6.2

This is a bug fix release

Check out the 0.6.2 milestone to see new features / bugfixes in detail.

Bug Fixes

  • 250 - Bind Object, not Provider in BaragonClientModule
Baragon-0.6.1 Baragon 0.6.1

This is a bug fix release

Check out the 0.6.1 milestone to see new features / bugfixes in detail.

Bug Fixes

  • 247 - Ignore duplicate names in cloudflare dns zone cache
  • 248 - Only bing GoogleCloudManager if credentials configured
Baragon-0.6.0 Baragon 0.6.0

Changes in 0.6.0

Check out the 0.6.0 milestone to see new features / bugfixes in detail.

New Features

  • 231 - Edge cache integration


  • 240 - Better logging and exception handling in agent
  • 245 - Expose the hosts provider and support ssl in client
  • 238 - Add ifContainedIn helper.
  • 244 - Add configuration to check gcloud health on startup/shutdown
  • 243 - Update JQuery
  • 239 - Make haystack parameter more generic in ifContainedIn Handlebars helper.
  • 230 - Use HostAndPort#getHostText instead of HostAndPort#getHost
  • 236 - Support default server factory
  • 228 - Avoid some calls to AWS API

Bug Fixes

  • 242 - Fix h4 headings
  • 241 - Dedupe dns records for zone
  • 237 - Only search for http connector port
  • 235 - EdgeCacheDNS -> edgeCacheDomains
  • 233 - Always call applyCurrentConfigs in checkStateNodeVersion


  • @baconmania
  • @stevegutz
  • @jonathanwgoodwin
  • @PtrTeixeira
Other projects in Java