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. |
|
containariumd
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 the agent model gateway (docs/AGENT-MODEL-GATEWAY-DESIGN.md): a credential proxy that can run standalone, without the LXC daemon.
|
Command model-gateway is the agent model gateway (docs/AGENT-MODEL-GATEWAY-DESIGN.md): a credential proxy that can run standalone, without the LXC daemon. |
|
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. |
|
agentengine
Package agentengine resolves which agent engine (and which gateway provider) one skill run uses, given the manifest's own choice and the daemon's gateway state.
|
Package agentengine resolves which agent engine (and which gateway provider) one skill run uses, given the manifest's own choice and the daemon's gateway state. |
|
anonbox
Package anonbox is the daemon side of the `ssh new.<cloud-domain>` door (docs/architecture/ssh-new-anonymous-box.md, #2197): it owns the SSH-key-fingerprint → VM mapping for anonymous boxes.
|
Package anonbox is the daemon side of the `ssh new.<cloud-domain>` door (docs/architecture/ssh-new-anonymous-box.md, #2197): it owns the SSH-key-fingerprint → VM mapping for anonymous boxes. |
|
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. |
|
backupkey
Package backupkey holds the operator-side steps of a managed-key restore or verify (#2403), shared by `containarium backup restore|verify` and the MCP restore_backup / verify_backup tools so both run the same code: picking the newest record, and unwrapping a record's per-backup age identity under the caller's own KMS credentials.
|
Package backupkey holds the operator-side steps of a managed-key restore or verify (#2403), shared by `containarium backup restore|verify` and the MCP restore_backup / verify_backup tools so both run the same code: picking the newest record, and unwrapping a record's per-backup age identity under the caller's own KMS credentials. |
|
bridgedns
Package bridgedns keeps the Incus bridge's raw.dnsmasq record equal to what the daemon would write for core-caddy's live address (#2188).
|
Package bridgedns keeps the Incus bridge's raw.dnsmasq record equal to what the daemon would write for core-caddy's live address (#2188). |
|
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. |
|
cluster
Package cluster holds the record types, validation, and persistence for managed Kubernetes clusters (#1413) — a platform-operated k3s control plane plus worker VMs in typed size classes.
|
Package cluster holds the record types, validation, and persistence for managed Kubernetes clusters (#1413) — a platform-operated k3s control plane plus worker VMs in typed size classes. |
|
cmd
`containarium bridge-dns status` — whether the bridge DNS record that resolves the app-hosting base domain to core-caddy matches core-caddy's live address (#2188).
|
`containarium bridge-dns status` — whether the bridge DNS record that resolves the app-hosting base domain to core-caddy matches core-caddy's live address (#2188). |
|
codeegress
Package codeegress holds the pure half of the coding tool's egress allowlist (#2370, docs/architecture/coding-cli-egress-allowlist.md): validating a CodingToolEgressPolicy and resolving the effective policy a run takes.
|
Package codeegress holds the pure half of the coding tool's egress allowlist (#2370, docs/architecture/coding-cli-egress-allowlist.md): validating a CodingToolEgressPolicy and resolving the effective policy a run takes. |
|
coderun
Package coderun implements the client half of `containarium code` (#1674): a resumable reader over agent-box's tail_log, so a run started on a box survives the local client's connection dying mid-stream.
|
Package coderun implements the client half of `containarium code` (#1674): a resumable reader over agent-box's tail_log, so a run started on a box survives the local client's connection dying mid-stream. |
|
coderun/engine
Package engine makes the coding agent and its credential source typed choices in `containarium code` (#1727), instead of the Claude-only, tenant-secret-only path #1673/#1674 shipped.
|
Package engine makes the coding agent and its credential source typed choices in `containarium code` (#1727), instead of the Claude-only, tenant-secret-only path #1673/#1674 shipped. |
|
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). |
|
coreguard
Package coreguard computes the network ACLs that isolate the platform's core-role containers (core-postgres, core-victoriametrics, ...) from tenant containers sharing the same Incus bridge.
|
Package coreguard computes the network ACLs that isolate the platform's core-role containers (core-postgres, core-victoriametrics, ...) from tenant containers sharing the same Incus bridge. |
|
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). |
|
gatewayprovider
Package gatewayprovider maps the GatewayProvider proto enum to and from the provider names the model gateway's registry is keyed by.
|
Package gatewayprovider maps the GatewayProvider proto enum to and from the provider names the model gateway's registry is keyed by. |
|
guardrail
Package guardrail drives a detection engine over a set of text units, redacts what it flagged, re-scans the result as the gate, and signs an attestation a consumer can verify before it touches the data (docs/architecture/guardrail.md).
|
Package guardrail drives a detection engine over a set of text units, redacts what it flagged, re-scans the result as the gate, and signs an attestation a consumer can verify before it touches the data (docs/architecture/guardrail.md). |
|
guardrailpolicy
Package guardrailpolicy stores the cluster-wide, admin-owned guardrail policy (#2368; docs/architecture/guardrail-inbound-and-server-policy.md, "Policy service").
|
Package guardrailpolicy stores the cluster-wide, admin-owned guardrail policy (#2368; docs/architecture/guardrail-inbound-and-server-policy.md, "Policy service"). |
|
guardrailpolicy/pgstore
Package pgstore is the Postgres guardrailpolicy.Store.
|
Package pgstore is the Postgres guardrailpolicy.Store. |
|
guardrailpolicy/storetest
Package storetest is the behavioural contract every guardrailpolicy.Store must meet.
|
Package storetest is the behavioural contract every guardrailpolicy.Store must meet. |
|
guardrailrate
Package guardrailrate is the per-subject token-bucket rate limit on the guardrail APIs (#2404): the gated DeployRecipe path and GuardrailPolicyService Set/Get.
|
Package guardrailrate is the per-subject token-bucket rate limit on the guardrail APIs (#2404): the gated DeployRecipe path and GuardrailPolicyService Set/Get. |
|
guardrailstage
Package guardrailstage is the daemon-side staging area a gated recipe deploy reads its dataset from (#2368; docs/architecture/guardrail-inbound-and-server-policy.md, "The gate").
|
Package guardrailstage is the daemon-side staging area a gated recipe deploy reads its dataset from (#2368; docs/architecture/guardrail-inbound-and-server-policy.md, "The gate"). |
|
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. |
|
hostharden
Package hostharden applies narrow, single-purpose host mitigations that don't require the daemon's full eBPF network-policy engine.
|
Package hostharden applies narrow, single-purpose host mitigations that don't require the daemon's full eBPF network-policy engine. |
|
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. |
|
hostport
Package hostport provides a single, permissive "host:port" splitter.
|
Package hostport provides a single, permissive "host:port" splitter. |
|
hypervisor
Package hypervisor implements the host-side half of console access to a BYOC VM host that is itself unreachable — see docs/architecture/byoc-vm-console-access.md.
|
Package hypervisor implements the host-side half of console access to a BYOC VM host that is itself unreachable — see docs/architecture/byoc-vm-console-access.md. |
|
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. |
|
logframe
Package logframe implements the #1674 text-safe framing format shared by agent-box's writer (internal/agentbox, framed capture_mode) and the `containarium code` client's demuxer: one frame per line, "<stream> <base64(payload)>\n".
|
Package logframe implements the #1674 text-safe framing format shared by agent-box's writer (internal/agentbox, framed capture_mode) and the `containarium code` client's demuxer: one frame per line, "<stream> <base64(payload)>\n". |
|
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. |
|
nicguard
Package nicguard holds what the two Incus NIC-ACL guards share: the arming mode and its parser, the firewall-driver precondition, the bridge parser, and the create-or-update-on-drift ACL writer.
|
Package nicguard holds what the two Incus NIC-ACL guards share: the arming mode and its parser, the firewall-driver precondition, the bridge parser, and the create-or-update-on-drift ACL writer. |
|
policyreadiness
Package policyreadiness reports whether the daemon's policy stores are ready (#2483).
|
Package policyreadiness reports whether the daemon's policy stores are ready (#2483). |
|
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. |
|
runlease
Package runlease implements the pure lifecycle of a run's credentials.
|
Package runlease implements the pure lifecycle of a run's credentials. |
|
runlog
Package runlog is the client side of TailRunLog (#2096): the one Go function `containarium crew logs` and the MCP `crew_logs` tool both call.
|
Package runlog is the client side of TailRunLog (#2096): the one Go function `containarium crew logs` and the MCP `crew_logs` tool both call. |
|
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. |
|
sandbox/dialer
Package dialer caches gRPC connections to agent-box's resident SpawnService, one per pool member's bind-mounted unix socket (#1488 Phase 2/3).
|
Package dialer caches gRPC connections to agent-box's resident SpawnService, one per pool member's bind-mounted unix socket (#1488 Phase 2/3). |
|
sandbox/ipam
Package ipam allocates static IPv4 addresses for pool members (#1488 Phase 3): "Pool members get a statically allocated IP from a per-host IPAM range at warm time...
|
Package ipam allocates static IPv4 addresses for pool members (#1488 Phase 3): "Pool members get a statically allocated IP from a per-host IPAM range at warm time... |
|
sandbox/pool
Package pool implements the warm-pool reconciler and claim ring for ephemeral sandboxes (#1488 Phase 3): "Pool members are created and started by a background reconciler.
|
Package pool implements the warm-pool reconciler and claim ring for ephemeral sandboxes (#1488 Phase 3): "Pool members are created and started by a background reconciler. |
|
sandbox/ratelimit
Package ratelimit implements the per-tenant spawn rate limiter for SandboxServer.SpawnSandbox (#1488 Phase 4: "per-tenant rate limit").
|
Package ratelimit implements the per-tenant spawn rate limiter for SandboxServer.SpawnSandbox (#1488 Phase 4: "per-tenant rate limit"). |
|
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. |
|
sentinel/anondoor
Package anondoor is the sshpiperd plugin behind `ssh new.<cloud-domain>` (docs/architecture/ssh-new-anonymous-box.md, #2198): the sentinel-side half of the anonymous-box door.
|
Package anondoor is the sshpiperd plugin behind `ssh new.<cloud-domain>` (docs/architecture/ssh-new-anonymous-box.md, #2198): the sentinel-side half of the anonymous-box door. |
|
sentinel/sshauthz
Package sshauthz implements the sentinel's audit-only live SSH check.
|
Package sshauthz implements the sentinel's audit-only live SSH check. |
|
sentinel/sshban
Package sshban owns the sentinel SSH plugin's live source-IP failure budget.
|
Package sshban owns the sentinel SSH plugin's live source-IP failure budget. |
|
sentinel/sshsession
Package sshsession implements containarium#1980: a structured session lifecycle record for SSH connections accepted by the sentinel's sshpiperd.
|
Package sshsession implements containarium#1980: a structured session lifecycle record for SSH connections accepted by the sentinel's sshpiperd. |
|
sshauthz
Package sshauthz contains the daemon-side SSH authorization decision seam.
|
Package sshauthz contains the daemon-side SSH authorization decision seam. |
|
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. |
|
tenantguard
Package tenantguard computes and reconciles the network ACLs that keep one tenant's containers off another tenant's containers on a shared Incus bridge.
|
Package tenantguard computes and reconciles the network ACLs that keep one tenant's containers off another tenant's containers on a shared Incus bridge. |
|
testsupport/incusenv
Package incusenv asserts that a real, usable Incus is present before an Incus-backed integration test runs, and decides what to do when one is not (#1332).
|
Package incusenv asserts that a real, usable Incus is present before an Incus-backed integration test runs, and decides what to do when one is not (#1332). |
|
threatdetect
Package threatdetect holds the background security-detection engine: the rule registry, the finding store, and delivery.
|
Package threatdetect holds the background security-detection engine: the rule registry, the finding store, and delivery. |
|
tokenid
Package tokenid is the shared leaf for what a token issuer must keep to revoke a token it issued: the jti and its expiry.
|
Package tokenid is the shared leaf for what a token issuer must keep to revoke a token it issued: the jti and its expiry. |
|
tracker
Package tracker will hold the daemon-side tracker broker — agent-visible GitHub/GitLab issue and change-request verbs backed by a daemon-custody credential (#1920).
|
Package tracker will hold the daemon-side tracker broker — agent-visible GitHub/GitLab issue and change-request verbs backed by a daemon-custody credential (#1920). |
|
tracker/github
Package github translates internal/tracker's provider-neutral verbs to the GitHub REST API.
|
Package github translates internal/tracker's provider-neutral verbs to the GitHub REST API. |
|
tracker/gitlab
Package gitlab translates internal/tracker's provider-neutral verbs to the GitLab REST API (v4).
|
Package gitlab translates internal/tracker's provider-neutral verbs to the GitLab REST API (v4). |
|
tracker/submit
Package submit implements #1923's "no push credential in the box" change submission path: extracting a git bundle from the box, pushing it from a fresh temporary bare repository on the host, and handing the result to a provider adapter's OpenChange.
|
Package submit implements #1923's "no push credential in the box" change submission path: extracting a git bundle from the box, pushing it from a fresh temporary bare repository on the host, and handing the result to a provider adapter's OpenChange. |
|
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/k8s/boxmeta
Package boxmeta holds the labels and names that identify a K8s box's Kubernetes objects.
|
Package boxmeta holds the labels and names that identify a K8s box's Kubernetes objects. |
|
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/cluster
Package cluster provisions and reconciles managed-Kubernetes-cluster VMs (#1414): a platform-owned k3s control-plane VM plus worker VMs in typed size classes, driven over the Incus API.
|
Package cluster provisions and reconciles managed-Kubernetes-cluster VMs (#1414): a platform-owned k3s control-plane VM plus worker VMs in typed size classes, driven over the Incus API. |
|
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/sdlcskills
Package sdlcskills holds the pin for the SDLC role skills shipped in coding-agent boxes (#2065): which commit of FootprintAI/open-sdlc-skills, and the sha256 of the tarball built from it.
|
Package sdlcskills holds the pin for the SDLC role skills shipped in coding-agent boxes (#2065): which commit of FootprintAI/open-sdlc-skills, and the sha256 of the tarball built from it. |
|
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/sshdpolicy
Package sshdpolicy is the single source of truth for the SSH-server policy Containarium applies inside every box (#2424): the managed drop-in that turns password authentication off, and the pure evaluation of an sshd configuration against that policy.
|
Package sshdpolicy is the single source of truth for the SSH-server policy Containarium applies inside every box (#2424): the managed drop-in that turns password authentication off, and the pure evaluation of an sshd configuration against that policy. |
|
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/zfscrypt
Package zfscrypt drives the `zfs` CLI for per-tenant native encryption.
|
Package zfscrypt drives the `zfs` CLI for per-tenant native encryption. |
|
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
|
|
|
e2e/cluster
Package clustere2e is the gated KVM end-to-end lane for managed Kubernetes clusters (#1418) — the definition-of-done check for the managed-clusters MVP (design: docs/architecture/managed-k8s-clusters.md, "End-to-end" section).
|
Package clustere2e is the gated KVM end-to-end lane for managed Kubernetes clusters (#1418) — the definition-of-done check for the managed-clusters MVP (design: docs/architecture/managed-k8s-clusters.md, "End-to-end" section). |
|
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.
