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 Podman or Orbstack (for macOS) instead of docker.

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

git clone --depth 1 --branch latest https://github.com/juspay/hyperswitch
cd hyperswitch
scripts/setup.sh

The above command will:

• Check for prerequisites (Docker Compose/Podman)

• Set up necessary configurations (PostgreSQL, Redis)

• Let you select a setup option:

  • Standard: (Recommended) App server + Control Center + Web SDK

  • Full: Standard + Monitoring + Scheduler

  • Standalone App Server: Core services only App Server

• Start the selected services

• Provide link to access various components

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

Have Questions? Join our Slack Community to ask questions, share feedback, and collaborate. Prefer direct support? Use our Contact Us page to reach out.

Next step:

Account setup