Github url


by fabiolb

fabiolb /fabio

Consul Load-Balancing made simple

6.4K Stars 560 Forks Last release: 9 months ago (v1.5.13) MIT License 1.0K Commits 58 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

ReleaseLicense MITTravis CI StatusDownloadsDocker Pulls fabiolb


  1. If you are confused about the commit order for the v1.5.11 release please check the Release Notesfor an explanation.

  2. The 1.5.11 tag was wrongly pointing to commit 0297494e9a00f87d3e387b8c6ff0408c2f5db6a0 instead of commit 446fbba59da42ed73df67c3d738b9945dbf0790a. I have updated the v1.5.11 tag to point to the correct version and created v1.5.11-wrong tag to point to the old (wrong) version.

fabio is a fast, modern, zero-conf load balancing HTTP(S) and TCP router for deploying applications managed by consul.

Register your services in consul, provide a health check and fabio will start routing traffic to them. No configuration required. Deployment, upgrading and refactoring has never been easier.

fabio is developed and maintained by The Fabio Authors.

It powers some of the largest websites in The Netherlands (, Australia ( and Italy ( It delivers 23.000 req/sec every day since Sep 2015 without problems.

It integrates withConsul,Vault,Amazon ELB,Amazon API Gatewayand more.

It supports (Full feature list)

WatchKelsey Hightower demo Consul, Nomad, Vault and fabio at HashiConf EU 2016.

The full documentation is on

Getting started

  1. Install from source, binary,Docker or Homebrew. ```shell

go 1.9 or higher is required

go get (>= go1.9)

brew install fabio (OSX/macOS stable) brew install --devel fabio (OSX/macOS devel)

docker pull fabiolb/fabio (Docker) (pre-built binaries) ```

  1. Register your service in consul.

Make sure that each instance registers with a unique ServiceID and a service name without spaces.

  1. Register a health check in consul as described here.

By default fabio only watches services which have a passing health check, unless overriden with registry.consul.service.status.

  1. Register one
    tag per
    prefix it serves, e.g.:
# HTTP/S examples urlprefix-/css # path route # host specific path route # host specific catch all route urlprefix-/foo/bar strip=/foo # path stripping (forward '/bar' to upstream) urlprefix-/foo/bar proto=https # HTTPS upstream urlprefix-/foo/bar proto=https tlsskipverify=true # HTTPS upstream and self-signed cert # TCP examples urlprefix-:3306 proto=tcp # route external port 3306

Make sure the prefix for HTTP routes contains at least one slash (



See the full list of options in the Documentation.

  1. Start fabio without a config file (assuming a running consul agent on


) Watch the log output how fabio picks up the route to your service. Try starting/stopping your service to see how the routing table changes instantly. 2.

Send all your HTTP traffic to fabio on port


. For TCP proxying see TCP proxy. 3. Done

Author and Founder



This project exists thanks to all the people who contribute. [Contribute].


  • Contributions up to 14 Apr 2017 before 38f73da

MIT Licensed Copyright (c) 2017 eBay Software Foundation. All rights reserved.

  • Contributions after 14 Apr 2017 starting with 38f73da

MIT Licensed Copyright (c) 2017-2019 Frank Schroeder. All rights reserved.

See LICENSE for details.

Stargazers over Time

Stargazers over time

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.