Docs
Egress IPs
Each workspace owns one or more ips rows (address inet, warm_state text,
node_id uuid). The panel IPs section registers addresses and writes
them to Kumo’s egress_data managed Lua fragment.
Contract
| Path | Auth | Purpose |
|---|---|---|
GET /v1/panel/ips |
viewer+ | List egress IPs |
POST /v1/panel/ips |
operator+ | Register IP; triggers a policy_jobs publish |
Render + apply
POST /v1/panel/ips calls renderWorkspacePolicy(admin, workspaceId), then
applyPolicyToKumo(kumo, {...}, { admin, workspaceId }) which writes
managed/egress_data.lua and bumpConfigEpoch on the node.
Warm state ladder
warm_state |
Throughput cap | Notes |
|---|---|---|
cold |
TBD (Release B shaping) | New IP, no reputation yet |
warm |
TBD | Mid |
hot |
default Kumo limits | Steady-state |
Release B (shaping.toml) will resolve the per-state throughput caps.
PTR / rDNS
Operators are expected to set reverse DNS at the provider; this product does not automate PTR. Tied to Release B’s reputation ops work.
Related
- docs/operate/policy.md — render/apply pipeline.
- docs/build/domains.md — DKIM + per-domain source.
Last verified: Sat Jul 11 2026 17:00:00 GMT-0700 (Pacific Daylight Time). Cross-link maintained byscripts/check-docs-drift.sh (M54).