Running Hoverfly as a webserverΒΆ

See also

Please carefully read through Hoverfly as a webserver alongside this tutorial to gain a high-level understanding of what we are about to cover.

Below is a complete example how to capture data with Hoverfly running as a proxy, and how to save it in a simulation file.

hoverctl start
hoverctl mode capture
curl --proxy http://localhost:8500
hoverctl export simulation.json
hoverctl stop

Now we can use Hoverfly as a webserver in Simulate mode.

hoverctl start webserver
hoverctl import simulation.json
curl http://localhost:8500/a/b
hoverctl stop

Hoverfly returned a response to our request while running as a webserver, not as a proxy.

Notice that we issued a cURL command to http://localhost:8500/a/b instead of This is because when running as a webserver, Hoverfly strips the domain from the endpoint URL in the simulation.

This is explained in more detail in the Hoverfly as a webserver section.


Hoverfly starts in Simulate mode by default.