Kurtosis Documentation

Kurtosis is a tool for packaging and launching environments of containerized services where you want them, the way you want them, with one liners.

• Get started with a quickstart to launch an environment.
• Dive deeper with basic Kurtosis concepts.
• Write your own environment definition with a guide on writing a package.

To quickly see what Kurtosis feels like, check out the example snippets below:

Local Deploy on Docker

kurtosis run github.com/kurtosis-tech/basic-service-package

Output

CLI Output

Example Service C UI, mapped locally

Local deploy with feature flag and different numbers of each service

kurtosis run github.com/kurtosis-tech/basic-service-package \
  '{"service_a_count": 2, 
    "service_b_count": 2, 
    "service_c_count": 1,
    "party_mode": true}'

Output

CLI Output

Example Service C UI, mapped locally

Remote deploy on Kubernetes

kurtosis cluster set remote-kubernetes; kurtosis gateway > /dev/null 2>&1 &

kurtosis run github.com/kurtosis-tech/basic-service-package \
  '{"service_a_count": 2, 
    "service_b_count": 2, 
    "service_c_count": 1,
    "party_mode": true}'

Output

Note: The experience on remote k8s is the same as local Docker.

CLI Output

Example Service C UI, mapped locally