Skip to content
Tristan Morgan edited this page Mar 6, 2025 · 11 revisions

Install from source, binary, Docker.

go install github.com/fabiolb/fabio@latest          (>= go1.13)

docker pull fabiolb/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 fabiolb/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 fabiolb/fabio

The official Docker image contains the root CA certificates from a recent and updated Alpine 3.21 installation.

Clone this wiki locally