Getting started with iocaine on Debian
Last updated: 2025-12-23

# 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.