Ekko Proxy logo

Ekko Proxy round logo EKKO PROXY

A service virtualization proxy tool to monitor, record, playback, and mock web service and database calls

Ekko Proxy can be downloaded as a single runnable jar requiring only Java 8 or later to run. Downloads are available here and on github.
To run via the command line simply do the following:
 $ java -jar ekkoproxy-1.6.jar
You can override application settings on the command line, as in the example below, that specifies which port the application should be accessible on:
 $ java -jar ekkoproxy-1.6.jar --server.port=8081
For more details on installation and command line options please see the documentation link below.

Read installation docs
Ekko Proxy is a simple, yet very effective, service virtualization utility that can be used to monitor, record, playback and mock either HTTP messages (e.g. SOAP, JSON) flowing on a HTTP(S) connection or database calls (JDBC only). Ekko Proxy is used by placing it in-between a client application and a server. The client is configured to connect to Ekko Proxy, and Ekko Proxy forwards, records or plays back the data from the server, depending on mode of operation, along-with providing easy access to view and compare the requests / responses etc. in its user friendly interface.
Ekko Proxy also provides a WireMock editor and a set of everyday convenience tools for comparing, encoding, formatting, hashing, matching, and validating / encoding JWT data all executed safely on your own machine.
For comprehensive usage documentation please see the link below.

Explore usage docs
Ekko Proxy is free only for non-commercial / non-profit use, though not all features are available when running Ekko Proxy without a license.
If you want to use Ekko Proxy in a commercial setting then please contact sales regarding purchasing a license.

Read the full license
Contact Sales


Many service virtualization tools have a steep learning curve and can be cumbersome to setup. Luckily Ekko Proxy is not one of them - instead, using it's intuitive and simple UI, you can get setup and running in minutes.

We think every software developer should have an Ekko Proxy tool in their toolbox given it provides many benefits such as:

  • Validate APIs / JDBC calls early in the project by recording requests and playing back recorded or mocked responses.
  • Run your application on the go without requiring network access to backend systems / databases.
  • Simulate a variety of responses to test hard to replicate scenarios or error conditions / network delays & faults.
  • Minimize dependencies between service delivery teams allowing for a truly agile delivery model.
  • Load test applications or APIs without incurring potential costs associated with rate limits.
  • Increase development and testing time by reducing dependency on backend systems availability.
  • Integrate your application with dependent APIs or DBs before they are fully built.
  • Run various tools to compare, encode/decode, format, match, and hash data, validate / encode JWT tokens - all safely from your local machine or server without the inherent dangers of using similar online tools.
  • Save time by generating mocks automatically from HTTP requests, OpenAPI, Swagger or WSDL specifications.


There are many great features in Ekko Proxy - some of which are listed below:

  • Get up and running in minutes - no coding or complex setup required.
  • Create mock responses for API and DB calls with the Ekko Proxy WireMock Editor.
  • Record and playback requests and responses as they pass through Ekko Proxy.
  • View and compare requests or responses as they flow through Ekko Proxy instances.
  • Set or program various types of delays to simulate real response times for responses being played back.
  • Set or program various types of faults to simulate network / connection issues.
  • Configure expressions to organise recorded requests and responses in subfolders so you can easily find them.
  • Configure expressions to normalize requests for better matching with recorded responses.
  • Drag & drop recorded HTTP requests to a proxy to fire them at the target server.
  • Easily view the contents of JWT tokens along with validating their signature or encode new ones.
  • View, manage, resend existing recorded requests from the recordings drawer.
  • Import / export proxy settings, recordings or mocks.
  • Generate mocks straight from HTTP requests or from OpenAPI, Swagger or WSDL definitions.

Ekko Proxy Support

Bugs & Enhancements

Issues and enhancement requests can be raised on the github page here


For general support queries email support

New in Version 1.6

  • Added per mock delay functionality allowing for various types of delays to be set.
  • Added per mock fault functionality allowing for various types of faults to be set.
  • Created delay and fault Handlebars template helpers allowing for programmatic control of delays and faults.
  • Added additional Handlebars template helpers: truncateDate, pickRandom, randomInt, randomDecimal, range, array, parseJson, matches, contains, and math.
  • Updated text editor to add language support for HTML, CSS and JavaScript.
  • Added auto-complete to scenario fields enabling faster form filling.
The new delay, fault and Handlebars templating helpers are all documented here.

New in Version 1.5.1

  • When creating a proxy you can now easily set if you want CORS handled automatically.
  • Fixed TLS supported version issue resulting in 500 - No Appropriate Protocol errors when connecting to target servers that do not support TLSv1.
  • Fixed network proxy lib linkage error occurring on some Windows Server versions.
  • Fixed potential NPE if network proxy authentication is required but none has been configured.

Version 1.5 changes

  • Added option to generate mocks from http requests / responses.
  • A new tool to generate mocks directly from OpenAPI / Swagger has been added.
  • A new tool to generate mocks directly from WSDL files has been added.
  • Spring boot actuator has been configured and HTTP metrics for proxies are now recorded.
  • Added suggestions for headers when configuring mocks.
  • Content encoding now supports deflate and br (Brotli) on some operative systems.
  • Delays are now supported for JDBC mocks.
  • Various minor fixes and UI updates.
  • Added log file viewer in About page.
  • Added charting of requests / responses.

Version 1.4 changes

  • Added a new database proxy type for JDBC connections. This allows you to view JDBC calls and record or mock their responses.
  • Added inline search in text areas with highlighting.
  • See the proxy settings for a proxy in a new information tooltip.
  • Fixed missing response headers when using forwarding.
  • You can now install license files via the UI.
  • Added command line option to specify corporate proxy settings for external connections.
  • You can now upload a SSL certificate for a proxy making it easier to manage when running on a remote server.
  • Added option to import / export Ekko Proxy settings, recordings and mocks via the UI.
  • New tools SQL formatting option.
  • When creating a Ekko proxy the ports for which existing settings already exist are displayed as a suggestion.

Version 1.3.1 changes

Minor release with only UX improvements - including:

  • Added syntax highlighting for XML, JSON and JWT.
  • Left-hand drawer is now collapsible.
  • Added speed dial menu to proxy request and response panes with word wrap and formatting options.

Version 1.3 changes

  • Various minor bug fixes and improvements.
  • Added tooling for comparing, encoding, formatting, hashing, JWT and matching data.
  • Redesigned the proxy message details section to provide a more detailed view.
  • Added new Recordings drawer to the proxy view for management of recordings.
  • Listener port can now accept SSL connections.
  • Added support for JsonPath expressions.
  • Added Auto output format for displaying messages formatted based on the content-type header.
  • HTTP messages are now saved raw with an option to save them formatted.