Configuration

The single source of truth for a Host's configuration is <host-home>/host.json. The IMatrixHostConfig type (projects/matrix-3/packages/host-service/src/types.ts:51-61) is the schema. Everything else (per-runtime environment files, log paths, the NATS config file) is derived from host.json.

Pages

• Host config — host.json: HTTP, transport, authority root, auth mode.
• NATS config — embedded vs external NATS, port and data-dir defaults, the nats-server.conf file the wrapper writes.
• Runtime storage — where runtime.json records and per-runtime logs live, and how the Host derives those paths.
• Package storage — packages/system (seeded by the wrapper) vs packages/global (user-installed).
• Logs — Host stdout/stderr, NATS log files, per-runtime logs, and journald cap policy.
• Config inheritance — what is in host.json vs what is per-runtime in runtime-env/, and the read-modify-write rules.

See also

• Filesystem layout
• Environment variables
• Ports