Skip to content
WireMock
Docs
WireMock Java WireMock.Net Mock API Templates WireMock Cloud WireMock 2.x (Archive)
Need Help?
Q&A on Slack StackOverflow Commercial Options
Participate
Community Slack Contributor Guide Our GitHub This Website Code of Conduct
Resources
Mock API Templates Library WireMock Ecosystem Twitter Mastodon Slack Archive External Resources
Try WireMock Cloud

Download and Installation

WireMock Java is distributed in two flavours - a standard JAR containing just WireMock, and a standalone uber JAR containing WireMock plus all its dependencies.

Most of the standalone JAR’s dependencies are shaded i.e. they are hidden in alternative packages. This allows WireMock to be used in projects with conflicting versions of its dependencies. The standalone JAR is also runnable (see Running as a Standalone Process).

WireMock currently has two releases available. The 3.x release (below) and the new 4.x beta releases.

3.x Release Downloads

Section titled “3.x Release Downloads”

Test dependencies

Section titled “Test dependencies”

Add the following to your project’s pom.xml dependencies:

<dependency>
    <groupId>org.wiremock</groupId>
    <artifactId>wiremock</artifactId>
    <version>3.13.2</version>
    <scope>test</scope>
</dependency>

Then follow the next steps for JUnit 5+ or plain Java.

Standalone Service

Section titled “Standalone Service”

Run the following in a terminal:

Terminal window
docker run -it --rm -p 8080:8080 --name wiremock wiremock/wiremock:3.13.2

Learn more in the Docker guide.

Direct download

Section titled “Direct download”

If you want to run WireMock as a standalone process you can download the standalone JAR from here

4.x Beta Release Downloads

Section titled “4.x Beta Release Downloads”

The 4.x release of WireMock is currently in beta. These releases are under active development and we recommend you try it out. We would love to hear your feedback over on the community slack - https://slack.wiremock.org/

We have given these releases a beta label due to the fact that as we move forwards with the 4.x release there will be breaking changes. See the version 4 page for details on the current updates to the 4.x release.

The version 4 codebase has been refactored to break out the core of WireMock from the various dependencies on external libraries. This means that you can now choose which dependencies you want to include in your project.

Test dependencies

Section titled “Test dependencies”

Add the following to your project’s pom.xml dependencies. If JUnit 4 is used instead of JUnit 5 then replace wiremock-junit5 with wiremock-junit4.

<dependency>
    <groupId>org.wiremock</groupId>
    <artifactId>wiremock-core</artifactId>
    <version>4.0.0-beta.20</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.wiremock</groupId>
    <artifactId>wiremock-jetty</artifactId>
    <version>4.0.0-beta.20</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.wiremock</groupId>
    <artifactId>wiremock-junit5</artifactId>
    <version>4.0.0-beta.20</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.wiremock</groupId>
    <artifactId>wiremock-httpclient-apache5</artifactId>
    <version>4.0.0-beta.20</version>
    <scope>test</scope>
</dependency>

Then follow the next steps for JUnit 5+ or plain Java.

Standalone Service

Section titled “Standalone Service”

Run the following in a terminal:

<dependency>
  <groupId>org.wiremock</groupId>
  <artifactId>wiremock-standalone</artifactId>
  <version>4.0.0-beta.20</version>
  <scope>test</scope>
</dependency>

Direct download

Section titled “Direct download”

If you want to run WireMock as a standalone process you can download the standalone JAR from here