Skip to content

WireMock plugin

  • Plugin name: wiremock
  • Plugin class: io.gatehill.imposter.plugin.wiremock.WiremockPluginImpl


  • supports setting request headers, query parameters, and HTTP method.
  • supports response status code, response headers and response files (including templating).
  • supports body responses.
  • supports jsonBody responses.
  • supports multiple body patterns.
  • partial support for faults.
  • supports plain (root object) and multiple (root array) mappings files.

Install plugin

Option 1: Using the CLI

To use this plugin, install it with the Imposter CLI:

imposter plugin install -d wiremock

This will install the plugin version matching the current engine version used by the CLI. The next time you run imposter up, the plugin will be available.

Option 2: Install the plugin manually

To use this plugin, download the imposter-plugin-wiremock.jar JAR file from the Releases page.

Enable it with the following environment variables:


Using the plugin

Read the Configuration section to understand how to configure Imposter.


For working examples, see:


Let's assume your configuration is in a folder named wiremock-simple.

Docker example:

docker run -ti -p 8080:8080 \
    -v $PWD/wiremock-simple:/opt/imposter/config \

Standalone Java example:

java -jar distro/wiremock/build/libs/imposter-all.jar \
    --configDir ./wiremock-simple

This starts a mock server using the WireMock plugin. Responses are served based on the mappings files inside the wiremock-simple/mappings folder and the templated response files in the wiremock-simple/__files folder.

Using the example above, Imposter will parse the WireMock mappings files and create an HTTP mock on http://localhost:8080/.

Additional script context objects

There are no additional script context objects available.