Overview

In this short guide, we’ll install iocaine on a Debian system. We’re not going into configuration, see the main Getting Started guide for more information about post-installation steps.

Installing iocaine

We provide Debian packages for amd64 and aarch64 architectures in a convenient Apt repository. The binaries - unlike official Debian packages - are statically built, and should run on any Debian or Debian-based distribution, regardless of its version.

Lets get started! We’ll add a source, along with its signing key, handily downloadable in one go:

# curl -s https://iocaine.madhouse-project.org/_/debian/iocaine.sources \
       -o /etc/apt/sources.list.d/iocaine.sources

After an apt update, we’ll have two packages package available to install: iocaine-nightly and iocaine. We’re going to install the latter one: that’s going to be current stable version.

# apt install -y iocaine
Installing:
  iocaine

Summary:
  Upgrading: 0, Installing: 1, Removing: 0, Not Upgrading: 2
  Download size: 5418 kB
  Space needed: 28.4 MB / 222 MB available

Get:1 https://git.madhouse-project.org/api/packages/iocaine/debian unstable/main amd64 iocaine amd64 3.1.0-1 [5418 kB]
Fetched 5418 kB in 2s (3428 kB/s)
Selecting previously unselected package iocaine.
(Reading database ... 55170 files and directories currently installed.)
Preparing to unpack .../iocaine_3.1.0-1_amd64.deb ...
Unpacking iocaine (3.1.0-1) ...
Setting up iocaine (3.1.0-1) ...
Created symlink '/etc/systemd/system/multi-user.target.wants/iocaine.service' → '/usr/lib/systemd/system/iocaine.service'.
Processing triggers for man-db (2.13.1-1) ...

And voilá, we have it running!

# systemctl status iocaine.service
● iocaine.service - iocaine, the deadliest poison known to AI
     Loaded: loaded (/usr/lib/systemd/system/iocaine.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-12-23 11:32:29 UTC; 2s ago
 Invocation: f3603f3bb6ef4a84b5faeea8bd6785be
   Main PID: 1511 (iocaine)
      Tasks: 2 (limit: 4657)
     Memory: 25.9M (peak: 28M)
        CPU: 151ms
     CGroup: /system.slice/iocaine.service
             └─1511 /usr/bin/iocaine --config-path /etc/iocaine/config.kdl start

Dec 23 11:32:29 localhost systemd[1]: Starting iocaine.service - iocaine, the deadliest poison known to AI...
Dec 23 11:32:29 localhost iocaine[1511]: 2025-12-23T11:32:29.133122Z  WARN iocaine::user: No ai-robots-txt-path configured, using default
Dec 23 11:32:29 localhost iocaine[1511]: 2025-12-23T11:32:29.135816Z  WARN iocaine::user: No unwanted-asns.db-path configured, check disabled
Dec 23 11:32:29 localhost systemd[1]: Started iocaine.service - iocaine, the deadliest poison known to AI.