# Installation ### Setup Videos | Mode | Video Link | | ---------------- | ------------------------------------------------------------------------------------------------------ | | BAP Mode Setup | | | BAP Mode Testing | | | BPP Mode Setup | | | BPP Mode Testing | | ### Pre-requisites * Docker version 20.10 or above ([setup guide](https://docs.docker.com/desktop/)) ### Infra Requirements: 2 CPU, 8GB RAM - Ubuntu ### Installation 1. Go to the root path (`~/`) in your system and clone this [repository](https://github.com/ONEST-Network/protocol-server). ```sh git clone https://github.com/ONEST-Network/protocol-server.git cd protocol-server git checkout master ``` 2. Run below command to configuration, docker, shell scripts files to root(\`\~/\`) path. Following are the file that will be copied: `deploy-bap.sh, deploy-bpp.sh, default-bap-client.yml, default-bap-network.yml, default-bpp-client.yml, default-bpp-network.yml, docker_data/docker_compose.yaml` ```sh bash setup.sh ``` 3. Go to docker\_data directory and run docker command. ```sh cd ~/protocol-server/docker docker-compose up -d ``` 4. If sandbox registration is not done, Follow the steps [Generate Keys](/learn/integration-of-adaptors/beckn-protocol-server/generate-keys.md) to generate key pairs that will be used in registry entry and follow [Join the network](/onboarding-sandbox-registration.md)to register. 5. Update the client and network server configuration by following below setups: **For BAP:** * In the BAP Client and BAP Network codebases, update the `~/default-bap-client.yml` and `~/default-bap-network.yml` file with the following values: * Private Key: Copy the private key of your participant. * Public Key: Copy the public key of your participant. * Use the Registry lookup API to get the `subscriber id`, `subscriber url` and `unique key` . ``` curl --location 'https://sandbox.onest.network/onest/lookup' \ --header 'Content-Type: application/json' \ --data '{ "country": "IND", "type":"BAP" }' ``` * Subscriber ID: Get using registry lookup API * Subscriber URI: Get using registry lookup API * Unique Key: Get using registry lookup API * Registry URL: `https://sandbox.onest.network/onest` **For BPP:** * In the BPP Client and BPP Network codebases, update the `~/default-bpp-client.yml` and `~/default-bpp-network.yml` file with the following values: * Private Key: Copy the private key of your participant. * Public Key: Copy the public key of your participant. * Use the Registry lookup API to get the `subscriber id`, `subscriber url` and `unique key`. ``` curl --location 'https://sandbox.onest.network/onest/lookup' \ --header 'Content-Type: application/json' \ --data '{ "country": "IND", "type":"BPP" }' ``` * Subscriber ID: Get using registry lookup API * Subscriber URI: Get using registry lookup API * Unique Key: Get using registry lookup API * Registry URL: `https://sandbox.onest.network/onest` * Webhook URL: The endpoint URL of your service the hosts protocol APIs like search, on\_search etc. 5. After making the changes in configuration files, run the below commands to create bap/bpp client and network docker containers: * Execute `./deploy-bap.sh` file to deploy the BAP Client and Network. * Execute `./deploy-bpp.sh` file to deploy the BPP Client and Network. 6. Test the protocol server by following the steps in [Testing](/learn/integration-of-adaptors/beckn-protocol-server/testing.md)section. #### For PM2 Deployment For PM2 deployment you need to git clone protocol-server four times to setup the BAP Client and Network and BPP Client and Network. Then copy `~/default-bap-client.yml` and `~/default-bap-network.yml` to config directory in respective git clone directory of BAP Client and Network. Also copy `~/default-bpp-client.yml` and `~/default-bpp-network.yml` to config directory in respective git clone directory of BPP Client and Network. After configuration, Protocol Server can be run as below. To run the instance in Development Mode (For Debug Purposes): ``` npm run dev ``` To run the instance in Production Mode: ``` npm i -g pm2 pm2 start ecosystem.config.js ``` --- # Agent Instructions: 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://starterpack.onest.network/learn/integration-of-adaptors/beckn-protocol-server/installation.md?ask= ``` 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.