Directories
¶
| Path | Synopsis |
|---|---|
|
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. |
|
mcp-server
command
|
|
|
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. |
|
cmd
Security CLI subcommands — scan, findings, remediate.
|
Security CLI subcommands — scan, findings, remediate. |
|
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. |
|
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. |
|
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. |
|
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). |
|
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. |
|
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/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/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/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/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. |
|
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.
