Directories
¶
| Path | Synopsis |
|---|---|
|
apis
|
|
|
containarium/v1alpha1
Package v1alpha1 contains the API types for the containarium.dev group — the Box CRD the daemon reconciles into a per-tenant agent-box (Sandbox + Pipe + Secret + NetworkPolicy).
|
Package v1alpha1 contains the API types for the containarium.dev group — the Box CRD the daemon reconciles into a per-tenant agent-box (Sandbox + Pipe + Secret + NetworkPolicy). |
|
cmd
|
|
|
agent-box
command
agent-box is the in-the-box MCP server.
|
agent-box is the in-the-box MCP server. |
|
containarium
command
|
|
|
ebpf-phase0
command
Command ebpf-phase0 is the Go-side validator for the eBPF network isolation design's Phase 0.
|
Command ebpf-phase0 is the Go-side validator for the eBPF network isolation design's Phase 0. |
|
ebpf-phaseA
command
Command ebpf-phaseA is the on-backend validator for Phase A of the eBPF network-isolation design (docs/security/NETWORK-ISOLATION-DESIGN.md, #315).
|
Command ebpf-phaseA is the on-backend validator for Phase A of the eBPF network-isolation design (docs/security/NETWORK-ISOLATION-DESIGN.md, #315). |
|
mcp-server
command
|
|
|
model-gateway
command
Command model-gateway is a prototype of the agent model gateway (docs/AGENT-MODEL-GATEWAY-DESIGN.md).
|
Command model-gateway is a prototype of the agent model gateway (docs/AGENT-MODEL-GATEWAY-DESIGN.md). |
|
netpolicy-smoke
command
Command netpolicy-smoke is a throwaway end-to-end smoke test for the eBPF network-policy *enforcer* (#315 Phase A piece 6c).
|
Command netpolicy-smoke is a throwaway end-to-end smoke test for the eBPF network-policy *enforcer* (#315 Phase A piece 6c). |
|
distros
|
|
|
go/containariumotel
Package containariumotel is the Go telemetry distro for apps and services running on the Containarium platform.
|
Package containariumotel is the Go telemetry distro for apps and services running on the Containarium platform. |
|
go/containariumotel/grpc
Package grpc provides Containarium-flavored gRPC instrumentation.
|
Package grpc provides Containarium-flavored gRPC instrumentation. |
|
examples
|
|
|
helloworld-go
command
helloworld-go: tiny HTTP server demonstrating containariumotel.
|
helloworld-go: tiny HTTP server demonstrating containariumotel. |
|
internal
|
|
|
agentbox
Package agentbox is the in-the-box MCP server library — the tools agents use when working on a single Containarium box.
|
Package agentbox is the in-the-box MCP server library — the tools agents use when working on a single Containarium box. |
|
autosleep
Package autosleep ticks once a minute and stops user containers whose network activity has gone quiet for longer than their per-container idle threshold.
|
Package autosleep ticks once a minute and stops user containers whose network activity has gone quiet for longer than their per-container idle threshold. |
|
capabilities
Package capabilities turns a backend's host system info, GPU passthrough probe, and a bounded CPU/memory micro-benchmark into an explicit capability profile recorded at join.
|
Package capabilities turns a backend's host system info, GPU passthrough probe, and a bounded CPU/memory micro-benchmark into an explicit capability profile recorded at join. |
|
capacity
Package capacity turns a backend's implicit spare resources into an explicit, policy-bounded scheduling-headroom signal that the control plane can read through the backend surface (ListBackends).
|
Package capacity turns a backend's implicit spare resources into an explicit, policy-bounded scheduling-headroom signal that the control plane can read through the backend surface (ListBackends). |
|
cloud
Package cloud is the OSS daemon's cloud-actuation client (#354 / docs/CLOUD-ACTUATION-CLIENT-DESIGN.md): the opt-in mode where a registered host receives desired-state container assignments + per-org network policies from a cloud control plane and reconciles them locally.
|
Package cloud is the OSS daemon's cloud-actuation client (#354 / docs/CLOUD-ACTUATION-CLIENT-DESIGN.md): the opt-in mode where a registered host receives desired-state container assignments + per-org network policies from a cloud control plane and reconciles them locally. |
|
cmd
Security CLI subcommands — scan, findings, remediate.
|
Security CLI subcommands — scan, findings, remediate. |
|
config
Package config centralizes Containarium's environment-driven configuration.
|
Package config centralizes Containarium's environment-driven configuration. |
|
connectcore
Package connectcore holds the transport-agnostic core of the `containarium connect` flow — the container DTO, SSH-target resolution, and ssh-argv assembly — shared by the CLI verb (internal/cmd/connect.go) and the MCP `connect` tool (internal/mcp/connect.go).
|
Package connectcore holds the transport-agnostic core of the `containarium connect` flow — the container DTO, SSH-target resolution, and ssh-argv assembly — shared by the CLI verb (internal/cmd/connect.go) and the MCP `connect` tool (internal/mcp/connect.go). |
|
controller
Package controller holds the Box CRD reconciler — the operator half of the Kubernetes agent-box control plane (#995).
|
Package controller holds the Box CRD reconciler — the operator half of the Kubernetes agent-box control plane (#995). |
|
credentials
Package credentials manages the on-disk store of per-server CLI auth tokens at ~/.containarium/credentials.json, populated by `containarium login` and consumed by the rest of the CLI when no explicit --token / CONTAINARIUM_TOKEN is set.
|
Package credentials manages the on-disk store of per-server CLI auth tokens at ~/.containarium/credentials.json, populated by `containarium login` and consumed by the rest of the CLI when no explicit --token / CONTAINARIUM_TOKEN is set. |
|
egressproxy
Package egressproxy implements the host-side relay for "egress via client" (#808, Phase 2a).
|
Package egressproxy implements the host-side relay for "egress via client" (#808, Phase 2a). |
|
hostcheck
Package hostcheck is the host capability self-check from the daemon deploy contract (prd/oss/daemon-deploy-contract.md) — the checks behind the "capability trap": running uid/caps, writability of the daemon's paths, and a live useradd/userdel probe.
|
Package hostcheck is the host capability self-check from the daemon deploy contract (prd/oss/daemon-deploy-contract.md) — the checks behind the "capability trap": running uid/caps, writability of the daemon's paths, and a live useradd/userdel probe. |
|
hosting
Package hosting provides DNS and SSL setup automation for app hosting.
|
Package hosting provides DNS and SSL setup automation for app hosting. |
|
hosting/godaddy
Package godaddy provides a client for the GoDaddy API to manage DNS records.
|
Package godaddy provides a client for the GoDaddy API to manage DNS records. |
|
integrity
Package integrity turns a backend's own runtime state into a signed self-measurement that the control plane verifies out of band of the backend's normal reporting, to detect tampering of a backend's control plane.
|
Package integrity turns a backend's own runtime state into a signed self-measurement that the control plane verifies out of band of the backend's normal reporting, to detect tampering of a backend's control plane. |
|
metrics/cloudexport
Package cloudexport is the seam for opt-in export of Containarium's host/container infra metrics to a host cloud's native monitoring (GCP Cloud Monitoring first — #1069/#1070/#1071).
|
Package cloudexport is the seam for opt-in export of Containarium's host/container infra metrics to a host cloud's native monitoring (GCP Cloud Monitoring first — #1069/#1070/#1071). |
|
metrics/platformstats
Package platformstats accumulates platform-domain facts the cloud-native metrics export platform group (#1082/#1083/#1084) observes at each export tick: API request/error counts today, provisioning outcomes and connectivity state in follow-up issues.
|
Package platformstats accumulates platform-domain facts the cloud-native metrics export platform group (#1082/#1083/#1084) observes at each export tick: API request/error counts today, provisioning outcomes and connectivity state in follow-up issues. |
|
modelgateway
Package modelgateway is a prototype of the agent model gateway (docs/AGENT-MODEL-GATEWAY-DESIGN.md): a single egress point that holds the provider API key and brokers every agent box's model calls, so the key never lives in a box.
|
Package modelgateway is a prototype of the agent model gateway (docs/AGENT-MODEL-GATEWAY-DESIGN.md): a single egress point that holds the provider API key and brokers every agent box's model calls, so the key never lives in a box. |
|
netbpf
Package netbpf holds the host-side plumbing for the per-tenant network isolation feature (#315, Phase A): resolving each container's host veth (so the tc-bpf TC_INGRESS program can be attached to the sender side of every flow — see docs/security/NETWORK-ISOLATION-DESIGN.md, "Phase 0 validation findings") and, on Linux, loading/attaching the BPF programs themselves.
|
Package netbpf holds the host-side plumbing for the per-tenant network isolation feature (#315, Phase A): resolving each container's host veth (so the tc-bpf TC_INGRESS program can be attached to the sender side of every flow — see docs/security/NETWORK-ISOLATION-DESIGN.md, "Phase 0 validation findings") and, on Linux, loading/attaching the BPF programs themselves. |
|
netpolicy
Package netpolicy validates and compiles per-tenant NetworkPolicy values (the Phase A control-plane half of the eBPF network-isolation design) into the normalized form the per-veth TC_INGRESS BPF loader consumes.
|
Package netpolicy validates and compiles per-tenant NetworkPolicy values (the Phase A control-plane half of the eBPF network-isolation design) into the normalized form the per-veth TC_INGRESS BPF loader consumes. |
|
releasecheck
Package releasecheck reports the latest Containarium release published on GitHub, cached server-side so a busy fleet's status checks don't burn the unauthenticated GitHub rate limit (~60/hr).
|
Package releasecheck reports the latest Containarium release published on GitHub, cached server-side so a busy fleet's status checks don't burn the unauthenticated GitHub rate limit (~60/hr). |
|
releases
Package releases fetches the project's latest published GitHub release and caches it, so operators can see "a newer version is available" without every page load burning GitHub's unauthenticated rate limit (60 req/h/IP).
|
Package releases fetches the project's latest published GitHub release and caches it, so operators can see "a newer version is available" without every page load burning GitHub's unauthenticated rate limit (60 req/h/IP). |
|
reqrate
Package reqrate computes per-container HTTP request rates from the Caddy edge's structured (JSON) access log — the source for #231's request-rate plane.
|
Package reqrate computes per-container HTTP request rates from the Caddy edge's structured (JSON) access log — the source for #231's request-rate plane. |
|
runner
Package runner provisions Containarium boxes as ephemeral GitHub Actions self-hosted runners.
|
Package runner provisions Containarium boxes as ephemeral GitHub Actions self-hosted runners. |
|
safecast
Package safecast provides overflow-safe integer conversions.
|
Package safecast provides overflow-safe integer conversions. |
|
secrets
Package secrets implements the daemon-side Postgres-backed store for tenant secrets, layered on top of pkg/core/secrets crypto.
|
Package secrets implements the daemon-side Postgres-backed store for tenant secrets, layered on top of pkg/core/secrets crypto. |
|
sshconfig
Package sshconfig generates a self-contained OpenSSH config file for every container the user can reach.
|
Package sshconfig generates a self-contained OpenSSH config file for every container the user can reach. |
|
sshkey
Package sshkey detects, generates, and fingerprints local SSH keypairs for the `containarium ssh setup` flow (sub-task A5 of umbrella-issue #100).
|
Package sshkey detects, generates, and fingerprints local SSH keypairs for the `containarium ssh setup` flow (sub-task A5 of umbrella-issue #100). |
|
storageprobe
Package storageprobe measures whether one tenant's writeback stalls another tenant's fsync on a shared backend.
|
Package storageprobe measures whether one tenant's writeback stalls another tenant's fsync on a shared backend. |
|
transfer
Package transfer ships files from the local workstation into a remote Containarium container, via the same SSH path the demo flow uses (laptop → sentinel → sshpiper → backend → containarium-shell → incus exec).
|
Package transfer ships files from the local workstation into a remote Containarium container, via the same SSH path the demo flow uses (laptop → sentinel → sshpiper → backend → containarium-shell → incus exec). |
|
ttlsweeper
Package ttlsweeper enforces per-container TTLs by ticking once a minute and force-deleting any container whose ttl_expires_at has elapsed.
|
Package ttlsweeper enforces per-container TTLs by ticking once a minute and force-deleting any container whose ttl_expires_at has elapsed. |
|
waf
Package waf is the Tier 3 (#662) userspace-WAF-behind-eBPF-steering slice.
|
Package waf is the Tier 3 (#662) userspace-WAF-behind-eBPF-steering slice. |
|
wake
Package wake implements the "wake-on-HTTP" piece of the auto-sleep feature: when an auto-sleeping container's HTTP route is hit, Caddy proxies the request to the daemon's wake handler, the handler starts the container and waits until it's ready, then proxies the request through.
|
Package wake implements the "wake-on-HTTP" piece of the auto-sleep feature: when an auto-sleeping container's HTTP route is hit, Caddy proxies the request to the daemon's wake handler, the handler starts the container and waits until it's ready, then proxies the request through. |
|
pkg
|
|
|
core/backup
Package backup implements logical (pg_dump) database backups for the databases running inside Containarium containers, stored off the database host.
|
Package backup implements logical (pg_dump) database backups for the databases running inside Containarium containers, stored off the database host. |
|
core/box
Package box defines the runtime-neutral seam between the daemon and the substrate a box runs on.
|
Package box defines the runtime-neutral seam between the daemon and the substrate a box runs on. |
|
core/box/k8s
Package k8s implements box.BoxBackend on Kubernetes, declaring one kubernetes-sigs/agent-sandbox Sandbox CR per box: a per-tenant pod an agent reaches over SSH, serving the same agent-box stdio MCP surface as the LXC backend.
|
Package k8s implements box.BoxBackend on Kubernetes, declaring one kubernetes-sigs/agent-sandbox Sandbox CR per box: a per-tenant pod an agent reaches over SSH, serving the same agent-box stdio MCP surface as the LXC backend. |
|
core/box/lxc
Package lxc implements box.BoxBackend over the existing LXC/incus container.Manager.
|
Package lxc implements box.BoxBackend over the existing LXC/incus container.Manager. |
|
core/catalogsig
Package catalogsig provides an optional, offline provenance check for external skill/crew catalogs loaded from disk (#648).
|
Package catalogsig provides an optional, offline provenance check for external skill/crew catalogs loaded from disk (#648). |
|
core/container
Package container provides the high-level container lifecycle Manager used by both the OSS daemon and any future cloud daemon: create, start, stop, delete, resize, label, plus jump-server SSH provisioning and collaborator-account management.
|
Package container provides the high-level container lifecycle Manager used by both the OSS daemon and any future cloud daemon: create, start, stop, delete, resize, label, plus jump-server SSH provisioning and collaborator-account management. |
|
core/coresys
Package coresys manages the _containarium-core system container, which hosts the daemon's internal services (PostgreSQL, Redis, Caddy, VictoriaMetrics).
|
Package coresys manages the _containarium-core system container, which hosts the daemon's internal services (PostgreSQL, Redis, Caddy, VictoriaMetrics). |
|
core/crews
Package crews provides the built-in catalog of crews.
|
Package crews provides the built-in catalog of crews. |
|
core/expose
Package expose holds the business logic for "make a container port reachable on a public hostname." Both the `containarium expose-port` CLI subcommand and the platform MCP's `expose_port` tool delegate to this package — the CLI is the canonical surface, and the MCP tool is a thin wrapper around the same Run() function via a transport-specific adapter implementing APIClient.
|
Package expose holds the business logic for "make a container port reachable on a public hostname." Both the `containarium expose-port` CLI subcommand and the platform MCP's `expose_port` tool delegate to this package — the CLI is the canonical surface, and the MCP tool is a thin wrapper around the same Run() function via a transport-specific adapter implementing APIClient. |
|
core/incus
Package incus wraps the Incus/LXC API used to drive container lifecycle, networking, and storage on a Containarium host.
|
Package incus wraps the Incus/LXC API used to drive container lifecycle, networking, and storage on a Containarium host. |
|
core/incus/incustest
Package incustest provides test doubles for the incus package.
|
Package incustest provides test doubles for the incus package. |
|
core/network
Package network provides network primitives for Containarium hosts: passthrough TCP/UDP routing via iptables, port-forwarding setup, and PostgreSQL-backed persistence of route definitions.
|
Package network provides network primitives for Containarium hosts: passthrough TCP/UDP routing via iptables, port-forwarding setup, and PostgreSQL-backed persistence of route definitions. |
|
core/nodevm
Package nodevm provisions Incus VMs that each become a Containarium backend ("node") — carving one physical host into multiple pool-tagged nodes (e.g.
|
Package nodevm provisions Incus VMs that each become a Containarium backend ("node") — carving one physical host into multiple pool-tagged nodes (e.g. |
|
core/ospkg
Package ospkg abstracts over Linux package managers (apt on Debian / Ubuntu, dnf on RHEL / Fedora) so installer logic can target a single PackageManager interface regardless of the container's OS family.
|
Package ospkg abstracts over Linux package managers (apt on Debian / Ubuntu, dnf on RHEL / Fedora) so installer logic can target a single PackageManager interface regardless of the container's OS family. |
|
core/ostype
Package ostype detects the OS family of a container (Debian, RHEL, etc.) and maps Containarium's logical OSType to concrete Incus image names.
|
Package ostype detects the OS family of a container (Debian, RHEL, etc.) and maps Containarium's logical OSType to concrete Incus image names. |
|
core/pki
Package pki implements the Containarium peer-CA used to issue short-lived certificates for sentinel↔daemon and peer-to-peer HTTPS.
|
Package pki implements the Containarium peer-CA used to issue short-lived certificates for sentinel↔daemon and peer-to-peer HTTPS. |
|
core/recipes
Package recipes provides the built-in catalog of declarative GPU/app recipes.
|
Package recipes provides the built-in catalog of declarative GPU/app recipes. |
|
core/secrets
Package secrets implements the daemon-side cryptographic primitives for storing and retrieving tenant secrets per the design in docs/SECRETS-MANAGEMENT-DESIGN.md.
|
Package secrets implements the daemon-side cryptographic primitives for storing and retrieving tenant secrets per the design in docs/SECRETS-MANAGEMENT-DESIGN.md. |
|
core/skills
Package skills provides the built-in catalog of agent skills.
|
Package skills provides the built-in catalog of agent skills. |
|
core/stacks
Package stacks defines reusable software stacks (Node.js, Python, etc.) that can be installed inside a Containarium container as part of provisioning.
|
Package stacks defines reusable software stacks (Node.js, Python, etc.) that can be installed inside a Containarium container as part of provisioning. |
|
core/volume
Package volume orchestrates shared, multi-writer data volumes backed by CephFS custom (filesystem) volumes (#384).
|
Package volume orchestrates shared, multi-writer data volumes backed by CephFS custom (filesystem) volumes (#384). |
|
core/zfskey
Package zfskey provides per-tenant key custody for ZFS native encryption.
|
Package zfskey provides per-tenant key custody for ZFS native encryption. |
|
pb/containarium/cloud/v1
Package cloudv1 is a reverse proxy.
|
Package cloudv1 is a reverse proxy. |
|
pb/containarium/v1
Package containariumv1 is a reverse proxy.
|
Package containariumv1 is a reverse proxy. |
|
terraform
|
|
|
test
|
|
|
fixtures/ip-echo
command
ip-echo is a tiny HTTP server that echoes the requester's identity.
|
ip-echo is a tiny HTTP server that echoes the requester's identity. |
|
fixtures/proxyproto-relay
command
proxyproto-relay is a test fixture that mimics the sentinel's HTTPS forwarding path: it accepts TCP connections, optionally prepends a PROXY v2 header (using the same encoder the sentinel uses), and pipes bytes to a backend address.
|
proxyproto-relay is a test fixture that mimics the sentinel's HTTPS forwarding path: it accepts TCP connections, optionally prepends a PROXY v2 header (using the same encoder the sentinel uses), and pipes bytes to a backend address. |
|
fixtures/tier2-l4-lifecycle
command
tier2-l4-lifecycle: drives a real caddy-l4 server through the operations the daemon performs at runtime (EnableL4ProxyProtocol → ActivateL4 → AddL4Route * N → RemoveL4Route → ListL4Routes) and asserts the pattern B wrapping is intact at every step.
|
tier2-l4-lifecycle: drives a real caddy-l4 server through the operations the daemon performs at runtime (EnableL4ProxyProtocol → ActivateL4 → AddL4Route * N → RemoveL4Route → ListL4Routes) and asserts the pattern B wrapping is intact at every step. |
Click to show internal directories.
Click to hide internal directories.
