Using the JVM mock engine

May 21, 2026 ยท View on GitHub

Imposter supports different mock engine types: Docker, JVM and Native. This document describes how to use the JVM engine.

Prerequisites

Install a Java 11+ JVM.

For example, if you are using Homebrew install with:

brew install openjdk@11

Or choose a distribution of your choice, such as Eclipse Adoptium.

Configuration

User default

The easiest way to set the engine type is to edit your user default configuration in:

$HOME/.imposter/config.yaml

Set the engine key to jvm:

engine: jvm

Environment variable

If you don't want to set your user defaults you can set the following environment variable:

IMPOSTER_ENGINE=jvm

Command line argument

You can also provide the --engine-type (or -t) command line argument to the imposter up command:

Example:

imposter up --engine-type jvm

Or:

imposter up -t jvm