lizergsav/mockserver

MockServer enables easy mocking of any system you integrate with via HTTP or HTTPS with clients written in Java, JavaScript and Ruby. MockServer also includes a proxy that introspects all proxied traffic including encrypted SSL traffic and supports Port Forwarding, Web Proxying (i.e. HTTP proxy), HTTPS Tunneling Proxying (using HTTP CONNECT) and SOCKS Proxying (i.e. dynamic port forwarding).

MockServer               

Documentation

For usage guide please see: www.mock-server.com

Change Log

Please see: Change Log

Community

Chat
Feature Requests
Issues / Bugs
Backlog

Versions

Maven Central

Maven Central contains the following MockServer artifacts:

• mockserver-netty - an HTTP(S) web server that mocks and records requests and responses
• mockserver-netty:shaded - mockserver-netty (as above) with all dependencies embedded
• mockserver-war - a deployable WAR for mocking HTTP(S) responses (for any JEE web server)
• mockserver-proxy-war - a deployable WAR that records requests and responses (for any JEE web server)
• mockserver-maven-plugin - a maven plugin to start, stop and fork MockServer using maven
• mockserver-client-java - a Java client to communicate with both the server and the proxy

In addition MockServer SNAPSHOT artifacts can also be found on Sonatype.

Node Module & Grunt Plugin

NPM Registry contains the following module:

• mockserver-node - a Node.js module and Grunt plugin to start and stop MockServer
• mockserver-client-node - a Node.js client for both the MockServer and the proxy

Docker Hub

Docker Hub contains the following artifacts:

• MockServer Docker Container - a Docker container containing the Netty MockServer and proxy

Helm Chart

• MockServer Helm Chart - a Helm Chart that installs MockServer to a Kubernetes cluster, available versions:
  • 5.15.0
  • 5.14.0
  • 5.13.2
  • 5.13.1
  • 5.13.0
  • 5.12.0
  • 5.11.2
  • 5.11.1
  • 5.11.0
  • ...

MockServer Clients

• mockserver-client-ruby - Ruby client for both the MockServer and the proxy
• mockserver-client-java - a Java client for both the MockServer and the proxy
• mockserver-client-node - a Node.js and browser client for both the MockServer and the proxy
• kotest-extensions-kotest - Kotlin Kotest integration with MockServer

Previous Versions

Version	Date	Git & Docker Tag / Git Hash	Documentation	Java API	REST API
5.15.0 (latest)	11 Jan 2023	mockserver-5.15.0 / 7c071b	Documentation	Java API	5.15.x REST API
5.14.0	22 Aug 2022	mockserver-5.14.0 / 808eba	Documentation	Java API	5.14.x REST API
5.13.2	05 Apr 2022	mockserver-5.13.2 / 81105b	Documentation	Java API	5.13.x REST API
5.13.1	02 Apr 2022	mockserver-5.13.1 / 39d1cc	Documentation	Java API	5.13.x REST API
5.13.0	17 Mar 2022	mockserver-5.13.0 / 604888	Documentation	Java API	5.13.x REST API
5.12.0	12 Feb 2022	mockserver-5.12.0 / 61747f	Documentation	Java API	5.12.x REST API
5.11.2	08 Nov 2020	mockserver-5.11.2 / eb84f2	Documentation	Java API	5.11.x REST API
5.11.1	22 Jul 2020	mockserver-5.11.1 / 361e5c	Documentation	Java API	5.11.x REST API
5.11.0	08 Jul 2020	mockserver-5.11.0 / 756758	Documentation	Java API	5.11.x REST API
5.10.0	24 Mar 2020	mockserver-5.10.0 / 14124d	Documentation	Java API	5.10.x REST API
5.9.0	01 Feb 2020	mockserver-5.9.0 / eacf07	Documentation	Java API	5.9.x REST API
5.8.1	23 Dec 2019	mockserver-5.8.1 / f0e9ab	Documentation	Java API	5.8.x REST API
5.8.0	01 Dec 2019	mockserver-5.8.0 / 7c9fc5	Documentation	Java API	5.8.x REST API
5.7.2	16 Nov 2019	mockserver-5.7.2 / 7c9fc5	Documentation	Java API	5.7.x REST API
5.7.1	09 Nov 2019	mockserver-5.7.1 / 0ca353	Documentation	Java API	5.7.x REST API
5.7.0	01 Nov 2019	mockserver-5.7.0 / b58bc5	Documentation	Java API	5.7.x REST API
5.6.1	21 Jul 2019	mockserver-5.6.1 / aec1fb	Documentation	Java API	5.6.x REST API
5.6.0	21 Jun 2019	mockserver-5.6.0 / 8f82dc	Documentation	Java API	5.6.x REST API
5.5.4	26 Apr 2019	mockserver-5.5.4 / 4ffd31	Documentation	Java API	5.5.x REST API
5.5.1	29 Dec 2018	mockserver-5.5.1 / 11d8a9	Documentation	Java API	5.5.x REST API
5.5.0	15 Nov 2018	mockserver-5.5.0 / 06e6fd	Documentation	Java API	5.5.x REST API

Issues

If you have any problems, please check the project issues and avoid opening issues that have already been fixed. When you open an issue please provide the following information:

• MockServer version (i.e. 5.15.0)
• How your running the MockServer (i.e maven plugin, docker, etc)
• MockServer log output, at INFO level (or higher)
• What the error is
• What you are trying to do

Contributions

Pull requests are, of course, very welcome! Please read our contributing to the project guide first. Then head over to the open issues to see what we need help with. Make sure you let us know if you intend to work on something. Also check out to see what is already in the backlog.

Feature Requests

Feature requests are submitted to github issues. Once accepted they will be added to the backlog. Please check out to see what is already in the backlog.

Maintainers

• James D Bloom