Containarium v0.109.0

What changed

Added

• --no-auto-sleep / disable_auto_sleep opt-out for CLI, API and MCP (#2759) (#2691)
• ship SSH authentication failures and bans into the audit store (#2419) (#2694)

Fixed

• tie the terminal no-Origin exemption to a validated bearer (#2696) (#2701)
• pin sshpiper gateway image to the chart appVersion; document required gateway value (#2703) (#2725)
• InstallClamav is owner-only like TriggerClamavScan (#2692) (#2700)
• accept bearer-authenticated terminal upgrades with no Origin (#2696) (#2698)

Documentation

• supply-chain gates PRD — record the five decisions, status reviewed (#2649) (#2720)
• claims-hygiene pass — claims table, corrected wording and design-doc status, scrubbed names (#2558) (#2689)

Internal

• cut v0.109.0 — terminal no-Origin fix for server-side clients, InstallClamav owner-only, --no-auto-sleep, SSH-failure audit (#2746)
• attach an SPDX SBOM for every Linux binary (#2561) (#2715)
• block dependencies whose licence is not on the allow-list (#2561) (#2714)
• bump google.golang.org/api from 0.301.0 to 0.304.0 (#2704)
• bump golang.org/x/term from 0.46.0 to 0.47.0 (#2706)
• prove the tunnel client and sentinel interoperate before publishing (#2469) (#2688)

Other

• release: publish a .sha256 for the Helm chart; refresh RELEASE-PROCESS for the chart publish (#2697) (#2699)

Full diff: v0.108.0...v0.109.0

---

Containarium v0.109.0

The open-source, self-hostable, agent-native sandbox.

Binaries

Four binaries ship in this release:

Binary	Where it runs	What it does
containariumd	The host	The platform daemon plus host-side admin commands.
containarium	Your laptop / CI (linux, macOS, windows)	The client CLI: create, list, expose-port, ssh-config, etc. against a server (--server).
mcp-server	Your laptop	The platform MCP — outside-the-box admin (create_container, list_containers, expose_port, list_backends). Wire it into Claude Code / Cursor.
agent-box	Inside each Containarium container	The in-the-box MCP — shell_exec, read_file, write_file, etc. Reached over stdio, typically via SSH.

Quick install (Linux host)

curl -fsSL https://raw.githubusercontent.com/footprintai/containarium/main/hacks/install.sh | sudo bash

Manual install (any binary, any platform)

# containariumd daemon (Linux x86_64 host)
curl -L -o /usr/local/bin/containariumd \
  https://github.com/footprintai/containarium/releases/download/v0.109.0/containariumd-linux-amd64
chmod +x /usr/local/bin/containariumd
ln -sf /usr/local/bin/containariumd /usr/local/bin/containarium

# containarium client CLI (your laptop, e.g. macOS arm64)
curl -L -o /usr/local/bin/containarium \
  https://github.com/footprintai/containarium/releases/download/v0.109.0/containarium-darwin-arm64
chmod +x /usr/local/bin/containarium

# Windows: the same client CLI (create/list/ssh/… against a remote server)
# PowerShell:
#   curl.exe -L -o containarium.exe `
#     https://github.com/footprintai/containarium/releases/download/v0.109.0/containarium-windows-amd64.exe

# platform MCP (your laptop, e.g. macOS arm64)
curl -L -o /usr/local/bin/mcp-server \
  https://github.com/footprintai/containarium/releases/download/v0.109.0/mcp-server-darwin-arm64
chmod +x /usr/local/bin/mcp-server

# agent-box (drop into your container image, Linux x86_64)
curl -L -o /usr/local/bin/agent-box \
  https://github.com/footprintai/containarium/releases/download/v0.109.0/agent-box-linux-amd64
chmod +x /usr/local/bin/agent-box

Verify checksums via SHA256SUMS.txt.

SBOMs

Each Linux binary has an SPDX 2.3 SBOM next to it (<binary>-linux-amd64.spdx.json), generated from the shipped file and listed in SHA256SUMS.txt. The container images carry their own SBOM and provenance attestations.

Kubernetes (Helm)

Chart version 0.109.0 (installs the v0.109.0 daemon image):

helm install containarium oci://ghcr.io/footprintai/charts/containarium-k8s \
  --version 0.109.0 \
  --set daemon.jwtSecret="$(openssl rand -hex 24)" \
  --set gateway.upstreamKeySecret=sshpiper-upstream-key \
  --set-file gateway.upstreamPublicKey=./sshpiper_upstream.pub

MCP client setup

Wire the platform MCP into Claude Code (~/.claude.json):

{
  "mcpServers": {
    "containarium": {
      "command": "/usr/local/bin/mcp-server",
      "env": {
        "CONTAINARIUM_SERVER_URL": "http://your-host:8080",
        "CONTAINARIUM_JWT_TOKEN": "<your-token>"
      }
    }
  }
}

Wire agent-box for in-the-box file/shell ops:

{
  "mcpServers": {
    "containarium-box": {
      "command": "ssh",
      "args": ["user@your-box", "agent-box"]
    }
  }
}

See README.md for the full agent-native walkthrough.