Forge

Forge is Aurum’s deployment and operations boundary. It accepts versioned projects, manages runtime lifecycle through aurumd, exposes binary Connect RPCs and one Protobuf realtime stream, and stores runtime history in ClickHouse.

Read this first: Deploy a Project — the end-to-end deployment workflow.

  • Deploy a version — Register a target, push immutable source, and start the project.

  • Remote targets — Understand SSH delivery and the separate public API address.

  • Operate projects — Inspect state, follow logs, stop a run, and diagnose health.

Product boundary

aurum CLI --SSH--> Forge host
                       |
                       +-- aurumd: inventory and lifecycle
                       +-- runtime: live resources and WebSocket
                       +-- ClickHouse: durable history
                       +-- API: stable public HTTP/WS boundary

Terminal is a separate client of the Forge API. It does not connect directly to aurumd, a runtime process, or ClickHouse.

Self-hosted Forge installation is supplied with the licensed deployment package. Repository build commands and internal service scripts are not part of the product interface documented here.