On this page

Before you begin

Choose the product and operating system you want to install. Follow its guide from start to finish.

Choose the right product

Product What it does What you need from your CoCoCo contact
Steiger Runs and manages the on-site CoCoCo appliance and its application services. A join token, the intended server details and the site network plan.
Hybrid Bridge Connects on-site systems and integration workflows to the platform. A provisioning bundle for this bridge and the systems it will connect to.
CoCoCo CLI (cococo-cli) Lets authorised administrators manage platform configuration from a terminal. The command is cococo. The platform address, environment name, account access and workspace instructions.

You may need one or more of these products. Your implementation team should confirm which software belongs on each machine. Do not install this software on a press controller or other production equipment without its owner's approval.

Installation and connection are separate steps. Steiger and Hybrid Bridge create background services. CoCoCo CLI is a command-line application and has no background service. Steiger still needs its join token; Hybrid Bridge still needs its provisioning bundle. A service showing “Running” does not by itself prove the site is connected.

Choose your route

Your machine Steiger Hybrid Bridge
Windows, Intel or AMD 64-bit Windows MSI; WSL 3.0 or later with WSL containers required. Windows MSI (x64); WSL is not required.
Windows, ARM64 This guide does not provide an ARM64 Steiger MSI. Ask your implementation team. This guide does not provide an ARM64 Bridge MSI. Ask your implementation team.
Ubuntu 24.04 or Debian 13, amd64 or arm64 Install the steiger apt package. Install the hybrid-bridge apt package.
macOS, Apple Silicon or Intel This guide does not provide a macOS Steiger installation. Install tripleclabs/tap/hybrid-bridge with Homebrew.

On Linux, amd64 means an Intel or AMD 64-bit processor; it does not mean AMD processors only. arm64 means a 64-bit ARM processor. Other Linux distributions are outside this guide. For Windows, confirm that the proposed Windows edition and machine meet your implementation team's requirements, particularly if Steiger will run inside a virtual machine.

For CoCoCo CLI, use the Windows x64 MSI, the Linux amd64/arm64 apt package, or tripleclabs/tap/cococo-cli-beta with Homebrew on macOS. Windows ARM64 is outside this guide. The CLI does not need WSL, Steiger or Hybrid Bridge installed locally. The CLI is currently in beta.

Have these ready

  • An administrator account on the target machine, and permission to restart it if needed. The CoCoCo CLI Windows MSI installs for the current user and does not require administrator access.
  • A machine that will remain powered on and connected to the network. Agree CPU, RAM, disk space and backup requirements with your implementation team; these depend on the workloads.
  • The correct join token or provisioning bundle. These are credentials: store them securely and do not paste them into a support ticket or shared chat.
  • Working DNS, an accurate system clock, and internet access to https://install.tripleclabs.de for downloads, plus GitHub access for the macOS Homebrew tap. Your contact must also provide the platform, registration, registry and on-site destinations needed by your installation.
  • The network/firewall plan, including any local clients that must reach the appliance. Software installation does not configure your site's router or external firewall.

If this machine already has any of these products installed, go to Updates and existing installations first. Do not remove an existing installation or its data to make a new installer run.