Run Hyperswitch Locally Using Docker

This setup automatically runs all three components of Hyperswitch (Backend, Control Center, and SDK) on your machine at once using Docker.

Setup using Docker

You can run Hyperswitch on your system using Docker compose. We recommend using Docker Desktop for Windows and Mac OS. On Linux, you can install Docker Engine directly.

You can alternatively use Orbstack or Podman instead of docker.

Once Docker is installed, launch the Docker app, then use the following command at the command line.

git clone --depth 1 --branch latest https://github.com/juspay/hyperswitch
cd hyperswitch
docker compose up -d
# This script verifies the setup and provides links to the individual components.
scripts/docker_output.sh

If you face any issues during setup, please feel free to post in the #dev-support channel in our Slack community, and our team will respond as soon as possible.

As the result of the above command you should see the below output:

If you're looking to Contribute to Hyperswitch, try setting up a development environment using Docker Compose.

Next step:

Account setup