On this page

Hybrid Bridge on Linux

These instructions are for Ubuntu 24.04 or Debian 13, on amd64 or arm64. These installations use apt, the operating system's software installer and updater. You do not need to build software or install developer tools.

1. Connect to the Linux machine

Use its terminal directly, or connect from Windows PowerShell using SSH if your administrator has enabled it. Replace your-user and server-address with the details you were given:

Terminal
ssh your-user@server-address

On the first connection, confirm the server fingerprint with your administrator before accepting it. After login, the following commands run on the Linux machine, not on your Windows PC.

sudo means “run this command with administrator privileges.” It may ask for your Linux account password. No characters appear while you type that password; this is normal. If the account is not allowed to use sudo, ask the Linux administrator to complete the installation.

Check the operating system and processor type:

Terminal
cat /etc/os-release
dpkg --print-architecture

Expect Ubuntu 24.04 or Debian 13, and amd64 or arm64. If these differ, ask your implementation team before continuing.

2. Add the CoCoCo software source

Run the following blocks in order. They add the official package source and its signing key. The key lets apt verify packages from this source.

Terminal
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -d -m 0755 /etc/apt/keyrings
Terminal
sudo curl -fsSL \
  https://install.tripleclabs.de/apt/tripleclabs.asc \
  -o /etc/apt/keyrings/tripleclabs.asc
sudo chmod 0644 /etc/apt/keyrings/tripleclabs.asc
Terminal
sudo curl -fsSL \
  https://install.tripleclabs.de/apt/tripleclabs.sources \
  -o /etc/apt/sources.list.d/tripleclabs.sources
sudo apt update

A backslash at the end of a Linux command line means “continue on the next line.” Copy the complete block. Wait for each block to finish before starting the next. If a command fails, stop and resolve the error.

The last command must complete without a signature or certificate error. Never work around these errors by allowing unsigned packages. Use these steps once per machine, even if you need more than one product.

3. Install Hybrid Bridge

If you need the integration bridge, run:

Terminal
sudo apt install hybrid-bridge

The service does not start until it has a configuration. Save the bundle provided by your CoCoCo contact as a protected plain-text file on the Linux machine. For example, from a separate Windows PowerShell window, copy it to your SSH user's home folder:

Terminal
scp "C:\CoCoCo-Install\bridge-bundle.b64" your-user@server-address:

Return to the Linux terminal. If you used that filename and destination, run:

Terminal
chmod 600 "$HOME/bridge-bundle.b64"
sudo hybrid-bridge configure "$HOME/bridge-bundle.b64"
sudo systemctl start hybrid-bridge
sudo systemctl is-active hybrid-bridge

The configuration command should report successful provisioning, and the final command should print active. If provisioning fails, do not proceed as if the bridge were connected. Check the bundle and network access with your CoCoCo contact.

Confirm that the bridge appears connected in the platform and test an agreed integration. Handle the original bundle file according to your organisation's credential policy; retain the generated configuration and certificates.