stackkit-content-bridge

Overview ¶

Command stackkit-content-bridge is the node side of the kombify Content Bridge. It answers consented counts from the apps of one server as `homelab-content/v1`, strictly read-only, from a container that has no internet egress (HOMELAB-CONTENT-BRIDGE-STANDARD, docs/ADR/ADR-0047).

It is a separate binary on purpose: it links only the standard library and internal/contentbridge, so a read-only, capability-free container carries none of the CLI, API server or MCP code.

Configuration is environment only:

CONTENT_BRIDGE_HOMELAB_ID           installation identifier (required)
CONTENT_BRIDGE_LISTEN               default :8083
CONTENT_BRIDGE_IMMICH_URL           default http://immich-server:2283
CONTENT_BRIDGE_IMMICH_API_KEY_FILE  default /run/secrets/immich-api-key
CONTENT_BRIDGE_CACHE_TTL            default and maximum 60s