> For the complete documentation index, see [llms.txt](https://docs.hyperswitch.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hyperswitch.io/integration-guide/workflows/intelligent-routing/self-deployment-guide.md).

# Self-Deployment Guide

### Self-deploy and integrate it with your existing orchestrator

Juspay Hyperswitch's intelligent routing engine can be self-deployed to fit into your existing payments setup:

<figure><img src="/files/sYtzGXOLYgNsLUIhXCmU" alt=""><figcaption></figcaption></figure>

#### 1. Clone the Repository

```
git clone https://github.com/juspay/decision-engine.git
cd decision-engine
```

#### 2. Install Docker

```
Make sure Docker is installed on your system.
You can download and install Docker Desktop from the below links.

- Mac - https://docs.docker.com/desktop/setup/install/mac-install/
- Windows - https://docs.docker.com/desktop/setup/install/windows-install/
- Linux - https://docs.docker.com/desktop/setup/install/linux/
```

#### 3. Run the Project

**a. First-Time Setup**

If you're setting up the environment for the first time, run:

```
make init
```

This command performs the following under the hood:

```
docker-compose run --rm db-migrator && docker-compose up open-router
```

This will:

* Set up the environment
* Set up the database with the required schema
* Set up redis and the server for running the application
* Push the configs defined in the config.yaml & the static rules defined for routing in priority\_logic.txt to the DB

**b. Start the Server (without resetting DB)**

If the DB schema is already set up and you don't want to reset the DB, use:

```
make run
```

**System Requirements:** Approximately 2GB of disk space

After successful setup, the server will start running.

Once the server is set up, you can refer to the [API reference](https://api-reference.hyperswitch.io/) for usage.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hyperswitch.io/integration-guide/workflows/intelligent-routing/self-deployment-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.