Operate

How to run a Plasma platform — compose it, deploy it, investigate it, and debug it.

A platform is a model materialized on your nodes. You declare packages in compose.yaml, merge and prepare them, then bring the platform up against your infrastructure with plasmactl.

The golden rule of investigation

To understand a running platform, never read files by hand. Run:

plasmactl platform:graph

It returns the complete picture — nodes, zone allocations, component distribution, dependency edges — in seconds. → Investigating a platform

In this section

• Platform lifecycle — compose → prepare → bundle → up
• Nodes & topology — node files, zones, allocation, platform.yaml
• Deploying — zone targets, the full pipeline, the managed option
• Security — identity, access, secrets, hardened images
• Observability — metrics, logs, traces, dashboards, alerting
• Investigating a platform — platform:graph, check, impact
• Debugging — deployment issues, agent flows, RBAC

For the full command set, see the CLI reference.