Skip to content

Containarium v0.70.0

Choose a tag to compare

@github-actions github-actions released this 01 Sep 01:45
· 37 commits to main since this release
95ea2ad

What changed

Added

  • report the daemon version on /health (#1650)
  • admin RPC to set/clear a tenant's per-tenant KMS key (#1630) (#1631)

Fixed

  • ClearTenantKMSKey no longer rewraps existing secrets (#1637) (#1638)
  • verify the transferred binary before stopping any service (#1649)

Documentation

  • PRD + architecture design for continuous threat detection (#1639-#1643) (#1644)

Internal

  • group the k8s.io and OpenTelemetry module families (#1634)
  • bump otelgrpc to v0.71.0, matching otelhttp (#1633)
  • bump sigs.k8s.io/agent-sandbox to v1.0.0 and pin the e2e controller to match (#1632)
  • Bump github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric (#1627)
  • Bump go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp (#1621)
  • Bump google.golang.org/api from 0.293.0 to 0.294.0 (#1620)
  • Bump k8s.io/client-go from 0.36.4 to 0.37.0 (#1626)
  • Bump go.opentelemetry.io/otel/metric from 1.45.0 to 1.46.0 (#1628)

Full diff: v0.69.0...v0.70.0


Containarium v0.70.0

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

Binaries

Three binaries ship in this release:

Binary Where it runs What it does
containarium The host (and your laptop, for the CLI) The platform daemon + CLI. create, list, expose-port, ssh-config, etc.
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)

# containarium CLI / daemon (Linux x86_64 example)
curl -L -o /usr/local/bin/containarium \
  https://github.com/footprintai/containarium/releases/download/v0.70.0/containarium-linux-amd64
chmod +x /usr/local/bin/containarium

# Windows: client-only CLI (create/list/ssh/… against a remote daemon;
# the daemon/sentinel/tunnel subcommands are Linux/macOS only)
# PowerShell:
#   curl.exe -L -o containarium.exe `
#     https://github.com/footprintai/containarium/releases/download/v0.70.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.70.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.70.0/agent-box-linux-amd64
chmod +x /usr/local/bin/agent-box

Verify checksums via SHA256SUMS.txt.

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.