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.

• MacOS 64bit

• Linux 32bit

• Linux 64bit

• Windows 32bit

• Windows 64bit

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 --versions hoverfly

You can switch to a previously installed version as well:

brew switch hoverfly <version>

To remove old versions :

brew cleanup hoverfly

Docker

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.

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.

See also

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

Kubernetes

You can use Helm to install Hoverfly directly to your Kubernetes cluster. A community-maintained chart is available on Artifact Hub.

Use helm repo add to add the chart repository:

helm repo add hoverfly https://afruktin.github.io/hoverfly-helm

Here is the command for a basic Hoverfly installation with the default settings:

helm install hoverfly hoverfly/hoverfly

The default installation runs Hoverfly in webserver mode and creates a ClusterIP type service, which makes it only reachable from within the cluster.

After the installation, you can use port forwarding to access the application on localhost:

kubectl port-forward svc/hoverfly 8888 8500

See more details in the chart documentation.