Installing Keploy
Keploy uses eBPF to intercept API calls at the network layer and generate test cases and mocks/stubs.
Choose your OS to get started 🚀
- Linux
- macOS
- Windows
Make sure your Linux kernel version is 5.10 or higher.
👉 Choose your preferred method:
- Native
- Docker
1. Install Keploy
curl --silent -O -L https://keploy.io/install.sh && source install.sh
2. Once done, You should see something like this:
▓██▓▄
▓▓▓▓██▓█▓▄
████████▓▒
▀▓▓███▄ ▄▄ ▄ ▌
▄▌▌▓▓████▄ ██ ▓█▀ ▄▌▀▄ ▓▓▌▄ ▓█ ▄▌▓▓▌▄ ▌▌ ▓
▓█████████▌▓▓ ██▓█▄ ▓█▄▓▓ ▐█▌ ██ ▓█ █▌ ██ █▌ █▓
▓▓▓▓▀▀▀▀▓▓▓▓▓▓▌ ██ █▓ ▓▌▄▄ ▐█▓▄▓█▀ █▓█ ▀█▄▄█▀ █▓█
▓▌ ▐█▌ █▌
▓
Keploy CLI
Available Commands:
example Example to record and test via keploy
config --generate generate the keploy configuration file
record record the keploy testcases from the API calls
test run the recorded testcases and execute assertions
update Update Keploy
Flags:
--debug Run in debug mode
-h, --help help for keploy
-v, --version version for keploy
Use "keploy [command] --help" for more information about a command.
🎉 Congratulations!
You’ve successfully installed Keploy on Linux.
🎬 Start Capturing Test Cases
- Go
- Node.js
- Java
- Python
Record the test cases
keploy record -c "go run main.go"
Run the test cases
keploy test -c "go run main.go" --delay 10
Record the test cases
keploy record -c "npm start"
Run the test cases
keploy test -c "npm start" --delay 10
Record the test cases
keploy record -c "mvn spring-boot:run"
Run the test cases
keploy test -c "mvn spring-boot:run" --delay 10
Record the test cases
keploy record -c "python app.py"
Run the test cases
keploy test -c "python app.py" --delay 10
📖 What’s Next?
Now, take it further by following the Quickstart Guide and see Keploy in action with your app.
Install Keploy with Docker on Linux
-
Make sure Docker is installed: You’ll need Docker installed on Linux
-
Install Keploy
curl --silent -O -L https://keploy.io/install.sh && source install.sh
- Once done, You should see something like this:
▓██▓▄
▓▓▓▓██▓█▓▄
████████▓▒
▀▓▓███▄ ▄▄ ▄ ▌
▄▌▌▓▓████▄ ██ ▓█▀ ▄▌▀▄ ▓▓▌▄ ▓█ ▄▌▓▓▌▄ ▌▌ ▓
▓█████████▌▓▓ ██▓█▄ ▓█▄▓▓ ▐█▌ ██ ▓█ █▌ ██ █▌ █▓
▓▓▓▓▀▀▀▀▓▓▓▓▓▓▌ ██ █▓ ▓▌▄▄ ▐█▓▄▓█▀ █▓█ ▀█▄▄█▀ █▓█
▓▌ ▐█▌ █▌
▓
Keploy CLI
Available Commands:
example Example to record and test via keploy
config --generate generate the keploy configuration file
record record the keploy testcases from the API calls
test run the recorded testcases and execute assertions
update Update Keploy
Flags:
--debug Run in debug mode
-h, --help help for keploy
-v, --version version for keploy
Use "keploy [command] --help" for more information about a command.
🎉 Congratulations!
You’ve successfully set up Keploy on Linux using Docker.
🎬 Start Capturing Test Cases
- Docker
- Docker Compose
Record the test cases
keploy record -c "docker run -p <appPort>:<hostPort> --name <containerName> --network keploy-network --rm <applicationImage>" --containerName "<containerName>" --delay 10
Run the test cases
keploy test -c "docker run -p <appPort>:<hostPort> --name <containerName> --network keploy-network --rm <applicationImage>" --containerName "<containerName>" --delay 20
Record the test cases
keploy record -c "docker compose up" --container-name <containerName> --build-delay 100
Run the test cases
keploy test -c "docker compose up" --container-name <containerName> --build-delay 50 --delay 20
📖 What’s Next?
Now, take it further by following the Quickstart Guide and see Keploy in action with your app.
Keploy does not natively support macOS. However, you can run it using Lima or Docker.
👉 Choose your preferred method:
- Lima
- Docker
Install Keploy with Lima
-
Check if Lima is installed: If you already have Lima, Go to Step 6.
-
Install Lima
brew install lima
-
Create a Debian instance [or any instance of your choice]
limactl create template://debian-12
-
Start the instance
limactl start debian-12
-
Enter the Linux shell
limactl shell debian-12
-
Install Keploy inside Lima
curl --silent -O -L https://keploy.io/install.sh && source install.sh
-
Once done, You should see something like this:
▓██▓▄
▓▓▓▓██▓█▓▄
████████▓▒
▀▓▓███▄ ▄▄ ▄ ▌
▄▌▌▓▓████▄ ██ ▓█▀ ▄▌▀▄ ▓▓▌▄ ▓█ ▄▌▓▓▌▄ ▌▌ ▓
▓█████████▌▓▓ ██▓█▄ ▓█▄▓▓ ▐█▌ ██ ▓█ █▌ ██ █▌ █▓
▓▓▓▓▀▀▀▀▓▓▓▓▓▓▌ ██ █▓ ▓▌▄▄ ▐█▓▄▓█▀ █▓█ ▀█▄▄█▀ █▓█
▓▌ ▐█▌ █▌
▓
Keploy CLI
Available Commands:
example Example to record and test via keploy
config --generate generate the keploy configuration file
record record the keploy testcases from the API calls
test run the recorded testcases and execute assertions
update Update Keploy
Flags:
--debug Run in debug mode
-h, --help help for keploy
-v, --version version for keploy
Use "keploy [command] --help" for more information about a command.
🎉 Congratulations!
You’ve successfully set up Keploy on macOS using Lima.
🎬 Start Capturing Test Cases
- Go
- Node.js
- Java
- Python
Record the test cases
keploy record -c "go run main.go"
Run the test cases
keploy test -c "go run main.go" --delay 10
Record the test cases
keploy record -c "npm start"
Run the test cases
keploy test -c "npm start" --delay 10
Record the test cases
keploy record -c "mvn spring-boot:run"
Run the test cases
keploy test -c "mvn spring-boot:run" --delay 10
Record the test cases
keploy record -c "python app.py"
Run the test cases
keploy test -c "python app.py" --delay 10
📖 What’s Next?
Now, take it further by following the Quickstart Guide and see Keploy in action with your app.
Install Keploy with Docker on macOS
-
Make sure Docker is installed: You’ll need Docker Desktop running on macOS.
-
Install Keploy
curl --silent -O -L https://keploy.io/install.sh && source install.sh
-
Verify the installation
Once done, You should see something like this:
▓██▓▄
▓▓▓▓██▓█▓▄
████████▓▒
▀▓▓███▄ ▄▄ ▄ ▌
▄▌▌▓▓████▄ ██ ▓█▀ ▄▌▀▄ ▓▓▌▄ ▓█ ▄▌▓▓▌▄ ▌▌ ▓
▓█████████▌▓▓ ██▓█▄ ▓█▄▓▓ ▐█▌ ██ ▓█ █▌ ██ █▌ █▓
▓▓▓▓▀▀▀▀▓▓▓▓▓▓▌ ██ █▓ ▓▌▄▄ ▐█▓▄▓█▀ █▓█ ▀█▄▄█▀ █▓█
▓▌ ▐█▌ █▌
▓
Keploy CLI
Available Commands:
example Example to record and test via keploy
config --generate generate the keploy configuration file
record record the keploy testcases from the API calls
test run the recorded testcases and execute assertions
update Update Keploy
Flags:
--debug Run in debug mode
-h, --help help for keploy
-v, --version version for keploy
Use "keploy [command] --help" for more information about a command.
🎉 Congratulations!
You’ve successfully set up Keploy on macOS using Docker.
🎬 Start Capturing Test Cases
- Docker
- Docker Compose
Record the test cases
keploy record -c "docker run -p <appPort>:<hostPort> --name <containerName> --network keploy-network --rm <applicationImage>" --containerName "<containerName>" --delay 10
Run the test cases
keploy test -c "docker run -p <appPort>:<hostPort> --name <containerName> --network keploy-network --rm <applicationImage>" --containerName "<containerName>" --delay 20
Record the test cases
keploy record -c "docker compose up" --container-name <containerName> --build-delay 100
Run the test cases
keploy test -c "docker compose up" --container-name <containerName> --build-delay 50 --delay 20
📖 What’s Next?
Now, take it further by following the Quickstart Guide and see Keploy in action with your app.
Keploy does not natively support Windows. However, you can run it using WSL or Docker.
👉 Choose your preferred method:
- WSL
- Docker
Install Keploy with WSL
If you already have WSL, Go to Step 2.
Note: Make sure you’re on:
- Windows 10 (version 2004 or later, build 19041+)
- Windows 11
Run the following command in PowerShell (as Administrator):
-
Enable WSL
wsl --install -d <Distribution Name>
👉 We recommend using Ubuntu-22.04 for the best experience. (You can also choose a different distribution if needed.)
-
Install Keploy Binary Inside your WSL terminal, run:
curl --silent -O -L https://keploy.io/install.sh && source install.sh
-
Verify Installation
▓██▓▄
▓▓▓▓██▓█▓▄
████████▓▒
▀▓▓███▄ ▄▄ ▄ ▌
▄▌▌▓▓████▄ ██ ▓█▀ ▄▌▀▄ ▓▓▌▄ ▓█ ▄▌▓▓▌▄ ▌▌ ▓
▓█████████▌▓▓ ██▓█▄ ▓█▄▓▓ ▐█▌ ██ ▓█ █▌ ██ █▌ █▓
▓▓▓▓▀▀▀▀▓▓▓▓▓▓▌ ██ █▓ ▓▌▄▄ ▐█▓▄▓█▀ █▓█ ▀█▄▄█▀ █▓█
▓▌ ▐█▌ █▌
▓
Keploy CLI
Available Commands:
example Example to record and test via keploy
config --generate generate the keploy configuration file
record record the keploy testcases from the API calls
test run the recorded testcases and execute assertions
update Update Keploy
Flags:
--debug Run in debug mode
-h, --help help for keploy
-v, --version version for keploy
Use "keploy [command] --help" for more information about a command.
🎉 Congratulations!
You’ve successfully set up Keploy on Windows using WSL.
🎬 Start Capturing Test Cases
- Go
- Node.js
- Java
- Python
Record the test cases
keploy record -c "go run main.go"
Run the test cases
keploy test -c "go run main.go" --delay 10
Record the test cases
keploy record -c "npm start"
Run the test cases
keploy test -c "npm start" --delay 10
Record the test cases
keploy record -c "mvn spring-boot:run"
Run the test cases
keploy test -c "mvn spring-boot:run" --delay 10
Record the test cases
keploy record -c "python app.py"
Run the test cases
keploy test -c "python app.py" --delay 10
📖 What’s Next?
Now, take it further by following the Quickstart Guide and see Keploy in action with your app.
Install Keploy with Docker on Windows
-
Make sure Docker is installed : You’ll need Docker Desktop running on Windows.
-
Install Keploy
curl --silent -O -L https://keploy.io/install.sh && source install.sh
-
Verify the installation
Once done, You should see something like this:
▓██▓▄
▓▓▓▓██▓█▓▄
████████▓▒
▀▓▓██ █▄ ▄▄ ▄ ▌
▄▌▌▓▓████▄ ██ ▓█▀ ▄▌▀▄ ▓▓▌▄ ▓█ ▄▌▓▓▌▄ ▌▌ ▓
▓█████████▌▓▓ ██▓█▄ ▓█▄▓▓ ▐█▌ ██ ▓█ █▌ ██ █▌ █▓
▓▓▓▓▀▀▀▀▓▓▓▓▓▓▌ ██ █▓ ▓▌▄▄ ▐█▓▄▓█▀ █▓█ ▀█▄▄█▀ █▓█
▓▌ ▐█▌ █▌
▓
Keploy CLI
Available Commands:
example Example to record and test via keploy
config --generate generate the keploy configuration file
record record the keploy testcases from the API calls
test run the recorded testcases and execute assertions
update Update Keploy
Flags:
--debug Run in debug mode
-h, --help help for keploy
-v, --version version for keploy
Use "keploy [command] --help" for more information about a command.
🎉 Congratulations!
You’ve successfully set up Keploy on Windows using Docker.
🎬 Start Capturing Test Cases
- Docker
- Docker Compose
Record the test cases
keploy record -c "docker run -p <appPort>:<hostPort> --name <containerName> --network keploy-network --rm <applicationImage>" --containerName "<containerName>" --delay 10
Run the test cases
keploy test -c "docker run -p <appPort>:<hostPort> --name <containerName> --network keploy-network --rm <applicationImage>" --containerName "<containerName>" --delay 20
Record the test cases
keploy record -c "docker compose up" --container-name <containerName> --build-delay 100
Run the test cases
keploy test -c "docker compose up" --container-name <containerName> --build-delay 50 --delay 20
📖 What’s Next?
Now, take it further by following the Quickstart Guide and see Keploy in action with your app.