On this page

Platform 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 Steiger

If you need the CoCoCo appliance, run:

Terminal
sudo apt install steiger
sudo steiger

Apt installs the required dependencies, including Podman, and starts the background service. Enter the join token in the Steiger console and follow its setup prompts. Keep the token out of shell commands and shared notes.

Check the service and appliance status:

Terminal
sudo systemctl is-active steiger
sudo steiger status

The service command should print active. An unconfigured status before you enter the join token is expected. After setup, confirm the appliance is connected and test its application URL from another machine on the intended network.