Installation

Install from source, binary, Docker or Homebrew.

GO15VENDOREXPERIMENT=1 go get github.com/fabiolb/fabio (go1.5.x)

go get github.com/fabiolb/fabio                     (>= go1.6)

brew install fabio                                  (OSX/macOS stable 1.1.x)
brew install --devel fabio                          (OSX/macOS devel  1.2.x)

docker pull magiconair/fabio                        (Docker)

https://github.com/fabiolb/fabio/releases           (pre-built binaries)

To start fabio run

./fabio

which will run it with the default configuration which is described in fabio.properties. To run it with a config file run it with

./fabio -cfg fabio.properties

or use the official Docker image and mount your own config file to /etc/fabio/fabio.properties

docker run -d -p 9999:9999 -p 9998:9998 -v $PWD/fabio/fabio.properties:/etc/fabio/fabio.properties magiconair/fabio

If you want to run the Docker image with one or more SSL certificates then you can store your configuration and certificates in /etc/fabio and mount the entire directory, e.g.

$ cat ~/fabio/fabio.properties
proxy.addr=:443;/etc/fabio/ssl/mycert.pem;/etc/fabio/ssl/mykey.pem

docker run -d -p 443:443 -p 9998:9998 -v $PWD/fabio:/etc/fabio magiconair/fabio

The official Docker image contains the root CA certificates from a recent and updated Ubuntu 12.04.5 LTS installation.