Skip to content

Latest commit

 

History

History
96 lines (61 loc) · 2.6 KB

install.md

File metadata and controls

96 lines (61 loc) · 2.6 KB
Raw

Installation

Imposter can be installed on Linux, macOS and Windows.

If you're looking to upgrade Imposter, see Upgrade.

Prerequisites

Imposter supports different mock engine types: Docker (default) and JVM. For more information about configuring the engine type see:

You must have at least one of the engine types configured to use Imposter.

Quick start

Use these instructions to get up and running quickly.

Homebrew

If you have Homebrew installed:

brew tap gatehill/imposter
brew install imposter

Shell script

Or, use this one liner (macOS and Linux only):

curl -L https://raw.githubusercontent.com/gatehill/imposter-cli/main/install/install_imposter.sh | bash -

Warning It is good practice to examine the script first.

See Releases for the latest version.

Manual install

macOS

Only Intel x86_64 and ARM64 are supported on macOS.

# see https://github.com/gatehill/imposter-cli/releases
export IMPOSTER_CLI_VERSION=0.1.0

curl -L -o imposter.tar.gz "https://github.com/gatehill/imposter-cli/releases/download/v${IMPOSTER_CLI_VERSION}/imposter_${IMPOSTER_CLI_VERSION}_macOS_x86_64.tar.gz"
tar xvf imposter.tar.gz
mv ./imposter /usr/local/bin/imposter

Linux

Intel x86_64, ARM32 and ARM64 is supported on Linux.

# see https://github.com/gatehill/imposter-cli/releases
export IMPOSTER_CLI_VERSION=0.1.0

# choose one
#export IMPOSTER_ARCH=arm64
#export IMPOSTER_ARCH=arm
export IMPOSTER_ARCH=x86_64

curl -L -o imposter.tar.gz "https://github.com/gatehill/imposter-cli/releases/download/v${IMPOSTER_CLI_VERSION}/imposter_${IMPOSTER_CLI_VERSION}_Linux_{IMPOSTER_ARCH}.tar.gz"
tar xvf imposter.tar.gz
mv ./imposter /usr/local/bin/imposter

Windows

Only Intel x86_64 is supported on Windows.

These instructions assume curl and unzip are available. You can also download the ZIP archive from the Releases page.

# see https://github.com/gatehill/imposter-cli/releases
SET IMPOSTER_CLI_VERSION=0.1.0

curl.exe --output imposter.zip --url "https://github.com/gatehill/imposter-cli/releases/download/v%IMPOSTER_CLI_VERSION%/imposter_%IMPOSTER_CLI_VERSION%_Windows_x86_64.zip"
unzip.exe imposter.zip

# use command (or add to PATH)
imposter.exe [command/args]

Uninstall

To uninstall, remove the imposter binary from /usr/local/bin (macOS and Linux only).

rm /usr/local/bin/imposter