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.
If you have homebrew, you can install Hoverfly using the
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 --versions 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 run -d -p 8888:8888 -p 8500:8500 spectolabs/hoverfly:latest
This will run the latest version of the Hoverfly Docker image.
You can also pass Hoverfly configuration flags when starting with Docker. For example if you need to run Hoverfly in webserver mode:
docker run -d -p 8888:8888 -p 8500:8500 spectolabs/hoverfly:latest -webserver
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.
For a tutorial of creating a new target in hoverctl, see Controlling a remote Hoverfly instance with hoverctl.