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:
ssh your-user@server-addressOn 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:
cat /etc/os-release
dpkg --print-architectureExpect 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.
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -d -m 0755 /etc/apt/keyringssudo curl -fsSL \
https://install.tripleclabs.de/apt/tripleclabs.asc \
-o /etc/apt/keyrings/tripleclabs.asc
sudo chmod 0644 /etc/apt/keyrings/tripleclabs.ascsudo curl -fsSL \
https://install.tripleclabs.de/apt/tripleclabs.sources \
-o /etc/apt/sources.list.d/tripleclabs.sources
sudo apt updateA 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:
sudo apt install hybrid-bridgeThe 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:
scp "C:\CoCoCo-Install\bridge-bundle.b64" your-user@server-address:Return to the Linux terminal. If you used that filename and destination, run:
chmod 600 "$HOME/bridge-bundle.b64"
sudo hybrid-bridge configure "$HOME/bridge-bundle.b64"
sudo systemctl start hybrid-bridge
sudo systemctl is-active hybrid-bridgeThe 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.