Configure Bridge in Qntrl | Bridge | Qntrl | Online Help

Install and Configure Bridge

Bridge is a lightweight agent that enables secure communication between Qntrl and your on-premise systems. This article provides step-by-step instructions to install Bridge across supported platforms.

Supported Platforms   

Operating System

Zip

Installer

Windows (64-bit)

✅

✅

Linux (64-bit)

✅

✅

macOS (64-bit)

✅

❌

 

NotesmacOS supports only the Zip installation method.

Prerequisite 

  •  Ensure you have administrator/root privileges

  • Review System Requirements

  • Only one Bridge agent can be installed per machine.


Step 1: Download Bridge

Only one Bridge agent can be installed per machine.

  1. Log in to Qntrl.
  2. Click the settings gear icon (⚙) in the left panel.
  3. Navigate to Bridge >> Downloads.
  4. Choose a Download Type:
    1. Zip Download – Compressed file; requires extraction and manual setup via command line.
    2. Installer – Direct installation via the setup wizard. You can download the installer directly or copy and execute the wget command.
  5. Select your OS and download the package.
Notes
macOS supports only the Zip download option.                                                            

Step 2: Install Bridge   

Common Configuration Prompts  for Zip Downloads  (Applies to all OS):

During installation, you will be prompted to configure the following:

  1. Proxy settings (optional):

    • yes – Enter proxy host, port, username, and password.

    • no – Disable proxy.

    • skip – Keep existing proxy settings unchanged.

  1. PostgreSQL settings (optional): To use an external PostgreSQL instance.

    • yes – Enter the host, port, username, and password.

    • no – Use bundled PostgreSQL.

    • skip – Keep existing configuration unchanged.

  1. Non-root username

    • Enter a local account (without administrative privileges).

    • If the username does not exist, the setup will prompt you to create it. Providing the user password is mandatory for Windows.

    • If a Bridge service already exists, you will be prompted to override it:

      • No – Installation will be terminated.

      • Yes – Installation will continue and overwrite the existing service.


Windows   

Installer

  1. Click the download icon to download the installer, or copy and execute the command provided.

  2. Locate the downloaded file and double-click to launch the setup wizard.

  3. Follow the setup wizard:

    1. Accept License Agreement

    2. Choose installation directory (default location: C:\Bridge)

    3. Configure Proxy settings (optional)

    4. Configure External PostgreSQL (optional) - By default, the bridge uses a bundled PostgreSQL database.

    5. Enter a a non-root user (local account without administrative privileges) to run the service. Password is mandatory for Windows.

    6. Review the summary and click Install.

    7. Once installation completes, click Done to close the wizard.

       

    Zip Download

    1. Download the zip file or copy and execute the command provided.

    2. Launch PowerShell as Administrator.

    3. Extract the zip: Expand-Archive -Force Bridge.zip 'C:\Bridge'

    4. Execute the installation command: cmd.exe /c 'C:\Bridge\bin\bridge.bat install' 

    5. Follow the common configuration prompts.

     

    Uninstall Bridge 

    1. Open an elevated PowerShell.

    2. Stop the Bridge: cmd.exe /c 'C:\Bridge\bin\bridge.bat' stop

    3. Uninstall the Bridge service: cmd.exe /c 'C:\Bridge\bin\bridge.bat' uninstall

    4. Remove the Bridge files: Remove-Item 'C:\Bridge' -Force -Recurse

     

    Linux      

    Installer 

    1. Click the download icon or copy the wget command and run it in your terminal. 

    2. Open a terminal and run the installer with root permission: sudo sh 'Bridge.bin'

    3. Follow the setup wizard:

      1. Accept License Agreement

      2. Choose installation directory (default: /Bridge)

      3. Configure Proxy settings (optional)

      4. Configure External PostgreSQL (optional) - By default, the bridge uses a bundled PostgreSQL database.

      5. Enter a a non-root user (local account without administrative privileges) to run the service.

      6. Review the summary and click Install.

      7. Once installation completes, click Done to close the wizard.


     

     Zip Download

    1. Download the zip file or copy the wget command and execute in the terminal.
    2. Open a terminal and extract the zip using the command (only if you are downloaded the file instead of command line): sudo unzip -d /Bridge Bridge.zip
    3. Execute the installation command with root permission: sudo sh /Bridge/bin/bridge.sh install
    4. Follow the common configuration prompts.

       

    Uninstall Bridge 

    1. Open a terminal.

    2. Stop the Bridge: sudo sh /Bridge/bin/bridge.sh stop

    3. Uninstall the Bridge service: sudo sh /Bridge/bin/bridge.sh uninstall

    4. Remove the Bridge files: sudo rm -rf /Bridge

     

    macOS  (Zip Download)

    1. Download the zip file or copy the wget command and execute in the terminal.

    2. Open a terminal and extract the zip using the command: unzip -d /Library/Bridge Bridge.zip

    3. Execute the installation command with root permission: sudo sh /Bridge/bin/bridge.sh install

    4. Follow the common configuration prompts.

     

    Uninstall Bridge 

    1. Open a terminal.

    2. Stop the Bridge: sudo sh /Library/Bridge/bin/bridge.sh stop

    3. Uninstall the Bridge service: sudo sh /Library/Bridge/bin/bridge.sh uninstall

    4. Remove the Bridge files: sudo rm -rf /Library/Bridge


    Step 3: Verify Installation   

    After installation:

    • Bridge service should be running

    • Bridge appears in Bridge home page

    • You can view version, status, and activity

     

    Info
    • Only one Bridge agent can be installed per machine.
    • A maximum of five Bridges can be active in an organization.
    • Once Bridge is configured, tasks can be executed through the Messages module in Bridge.
    Alert

    • Do not share Bridge files with anyone. Ensure the installation location is securely protected.

    • Do not modify or remove any properties within the Bridge configuration files. The internal files should not be edited, deleted, or shared.







    Next:
                





      • Related Articles

      • Bridge Agent Configuration

        The Bridge Agent serves is the local management console for your Bridge installation. It provides access to service configurations, execution logs, messages, credentials, and communication settings. The Agent UI is accessible only from within the ...

      • Other actions in Bridge

        You can perform various additional actions from the Bridge page to manage, monitor, and troubleshoot your Bridge setup. To access the Bridge page: In Qntrl, click the settings gear icon in the left pane bottom. Navigate to Advanced >> Bridge and ...

      • Bridge System Requirements

        Qntrl Bridge is a secure and efficient agent that facilitates secure data transfer between on-premise systems and the Qntrl cloud. To ensure optimal performance and stability, it’s essential to install Qntrl Bridge on systems that meet the minimum ...

      • Overview of Bridge

        What is a Bridge? Bridge is an installable, lightweight independent agent that can be deployed on the customer’s local network. It is compatible both on Windows and Linux machines with 64-bit OS. Its role is to facilitate communication between Qntrl ...

      • PowerShell Engine

        PowerShell Engine In Bridge, the PowerShell Engine module is used to perform actions in any Windows machines in the client's network using PowerShell script. Prerequisite While creating Credentials, select the type Powershell and provide the User ...