Step 1: Set up Bridge 

Setting up Bridge for Mac/Linux 

1. In the terminal, unzip the downloaded file in a new directory by typing the following command: 
   
1. unzip <file-name>
   
Note that  Java is bundled with the zip file. If you do not have Java installed in your host, go to, conf/wrapper-bridge.conf and change wrapper.java.command into jre/bin/java.

2. Go to the bin directory and run the Bridge using the commands: 
   
1. (./start.sh) or (./bridge.sh start)                      
   

1. Logs will be displayed in the current console.
   
2. If you close the window, the Bridge will be stopped.
   

1. sudo ./bridge.sh install
   
2. sudo ./start.sh

Note: You cannot install more than one Bridge service as a daemon on a Linux host. This is a limitation of the Tanuki wrapper service.

1. Open your browser and access http://<hostname>:8500 (if it is same host, then you can mention it as localhost). To get hostname, use hostname command.
2. 8500 is the default port. You can change it in conf/config.xml. Restart the Bridge if you need to change the port.
   
3. You can set proxy details in conf/config.xml. Restart the Bridge to update your changes.
   

1. You can verify the reason in wrapper logs (logs/wrapper.log) or bridge logs (logs/logs.txt)
   
2. Mostly, the startup fails if the webserver port is occupied by some other application.
   

Setting up Bridge for Windows

1. In the terminal, unzip the downloaded file in a new directory by typing the following command: 
   
1. unzip <file-name>
   
Note that Java is bundled with the zip file. If you do not have Java installed in your host, go to, conf/wrapper-bridge.conf and change  wrapper.java.command  into  jre/bin/java.exe

2. Go to the bin directory and run the Bridge using the commands: 
   
1. bridge.bat install and bridge.bat start         
   

1. Logs will be displayed in the current console.
   
2. If you close the window, the Bridge will be stopped.
   

Step 2: Create a new client 

1. Enter the Client Details :
   
1. Client Type: Select the type of application as Server-based Applications .
   
2. Client Name: Enter a client name.
   
3. Homepage URL: Enter the URL of homepage
   
4. Authorized Redirect URIs: Enter the Redirect URI populated in the previous section. (E.g., http://localhost:8500/account/authcallback )
2. Click Create .              

Enter the web server port (e.g.,  http://<hostname>:8500) in your browser , a new tab opens in the local port. Configure the client details here.

1. Enter the client details:
   
1. Accounts Domain: Select the domain you use, either localzoho.com or zoho.com.
   
2. Client ID: Enter the client ID generated in the pervious step.
   
1. Click + to create a new client. 
   
3. Client Secret: Enter the client secret generated in the pervious step.
4. Redirect URI: A redirect URI will be automatically populated.
   
2. Click  Save .

You will now be redirected to a confirmation page. Click  Accept .

Step 3: Login to Bridge 

1. Organization Name : Enter your Qntrl organization name for which this Bridge is being configured. 
   
2. Bridge Name : Enter the Bridge name created in Step 1 .
   
3. Registration Key : Enter the registration key of the created Bridge. This is available under Configuration section of Bridge details. 
   
   
4. Click Start Server.
   

1. User Name: Provide a user name.
   
2. Password: Enter a password.
   
3. Confirm Password: Re-enter the password.
4. Click Sign Up.

If you are unable to sign up,

1. Refresh the Bridge list page to view the current status your Bridge.
2. Check if you have filled the right data.
   
3. Click the Verify Organization button again, and try to refresh.
   

Step 4: Test the Bridge 

1. Navigate to  and select Messages under Bridge.
   
2. Click the New Message button.
   
3. Fill the details:
   
1. Title: Enter a title for your message.
   
1. Bridge: Select the Bridge you would like to test.
   
1. Module: Select the module in which you would like to test the Bridge.
   
1. Type: Select the message type.
   
1. Synchronous: Executes tasks in the same request and provides response.
   
2. Asynchronous: Executes tasks in the background and updates response automatically.
   
4. Request Data: Enter the JSON request data.
   
5. Response: If the type is Synchronous, you will be able to view the response to the request.
   
6. Click Execute.