Forge

Forge is Aurum’s deployment and operations boundary. It accepts versioned projects, manages runtime lifecycle through aurumd, exposes a public REST/WebSocket API, 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.