To create publicly hosted mock APIs without anything to install, learn more about WireMock Cloud.

Download options

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).

Test dependencies

Maven
Gradle
Kotlin
SBT
  • Maven
  • Gradle Groovy
  • Gradle Kotlin
  • Scala SBT

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

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

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

Add the following to your project's build.gradle:

testImplementation "org.wiremock:wiremock:3.4.2"

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

Add the following to your project's build.gradle.kts:

testImplementation("org.wiremock:wiremock:3.4.2")

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

Add the following to your project’s build.sbt:

libraryDependencies +=
  "org.wiremock" % "wiremock" % "3.4.2" % Test

Download the latest standalone JAR then run the following in a terminal:

java -jar wiremock-standalone-3.4.2.jar

Learn more in the running standalone guide.

Run the following in a terminal:

docker run -it --rm \
  -p 8080:8080 \
  --name wiremock \
  wiremock/wiremock:3.4.2

Learn more in the Docker guide.

Standalone Service

Run the following in a terminal:

docker run -it --rm -p 8080:8080 --name wiremock \
  wiremock/wiremock:3.4.2
<dependency>
    <groupId>org.wiremock</groupId>
    <artifactId>wiremock-standalone</artifactId>
    <version>3.4.2</version>
    <scope>test</scope>
</dependency>
testImplementation "org.wiremock:wiremock-standalone:3.4.2"

Learn more in the Docker guide.

Direct download

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