Download and installation

Hoverfly comes with a command line interface called hoverctl. Archives containing the Hoverfly and hoverctl binaries are available for the major operating systems and architectures.

Download the correct archive, extract the binaries and place them in a directory on your PATH.

Homebrew (MacOS)

If you have homebrew, you can install Hoverfly using the brew command.

brew install SpectoLabs/tap/hoverfly

To upgrade your existing hoverfly to the latest release:

brew upgrade hoverfly

To show which versions are installed in your machine:

brew list --version hoverfly

You can switch to a previously installed version as well:

brew switch hoverfly <version>

To remove old versions :

brew cleanup hoverfly


If you have Docker, you can run Hoverfly using the docker command.

docker run -d -p 8888:8888 -p 8500:8500 spectolabs/hoverfly:latest

This will run the latest version of the Hoverfly Docker image. This Docker image does not contain hoverctl. Our recommendation is to have hoverctl on your host machine and then configure hoverctl to use the newly started Hoverfly Docker instance as a new target.

See also

For a tutorial of creating a new target in hoverctl, see Controlling a remote Hoverfly instance with hoverctl.