Repository navigation
Description
Decided; now build it
The half of this issue that was a question is answered: ADR-0043 (#505, 2026-09-18) keeps the CA on prometheus and builds phoenix as the deployment host. The body as filed assumed step-ca sits beneath the estate root; it does not — the root is pathlen:0 (ADR-0037), which is why the tier has its own. The CA-key custody gap the ADR found is #496.
docs/runbooks/build-the-jumpbox.md is the procedure: phoenix, 10.0.30.70, VMID 170, a VM not an LXC, 2 vCPU / 4 GiB / 32 GB, no stack, no Docker, no age key, no CA — with a CAUTION that certificates/ca-key.pem does not come here. One cost the issue did not count and the ADR did: the Proxmox firewall on Saruman admits 8006 from Hicks only, so this widens ADR-0014's rule by one address on one port.
Why it moved
It is the root of the automation chain — #440, #445 and #448 hang on it, and only #449–#451 hang on #414 — and it has no predecessor: it needs Saruman, which exists. A milestone described as a strict chain should not hold the one item in it that is not blocked. Moved to the Saruman milestone beside #527.
Done when
phoenix is in network.md and hardware.md, architecture.md no longer says Not built yet, check_docs.py's absence marker is removed, and a make deploy from it has landed on one host.
Body as filed, superseded 2026-09-19
This estate has 34 ADRs, 20 runbooks, 95 alert rules and a convergence loop
that refuses to deploy without a pinned GPG signature — and it builds virtual
machines by clicking. The Packer, OpenTofu and Ansible issues that follow this
one close that gap. This is their prerequisite: there is nowhere for the
toolchain to live.
Today Proxmox is driven from a Hicks workstation by hand. Packer, OpenTofu and
Ansible want a host that holds an API token, an SSH key and a checkout, and that
host is a pet — it is the thing that rebuilds everything else.
What is decided by placement
VLAN 30, not 99. It drives the lab, and ADR-0031
already grants Hicks all of ImaginationLAN, so it needs no new rule. Putting it
on Winterfell would widen the management segment for exactly the reason
ADR-0008 argues against —
"Winterfell becomes busier and less special."
A dedicated Proxmox user and API token, not root@pam, per the same instinct
that gave the lab guest its own age recipient under
ADR-0020:
the token that can create VMs should not be the token that can do everything.
The open question this issue carries
The estate's CA currently lives on prometheus. scripts/gen-certs.sh
deliberately leaves the CA key without a passphrase — the trade is written down,
that interactive issuance leads to certificates nobody dares reissue — and
SECURITY.md records that host's disk and swap as unencrypted. So the root of
trust for the estate sits on the monitoring box, protected by file permissions.
Moving it to the jumpbox is not obviously right; it trades one unencrypted disk
for another. But it is worth deciding rather than inheriting. stacks/sensitive's
step-ca is already an intermediate beneath that root (#130),
so the tree is shaped for it either way. Decide here, record it, and do not
move the key as a side effect of this build.
Order of work
- Guest on
Saruman, VLAN 30, static below.100with a Kea reservation. - Proxmox user and API token, privilege separation off, credential into
secrets/. - Alloy agent via
scripts/deploy-agent.sh— it is a lab host, so it pushes to
the lab's stack onalexander, never to10.0.99.20
(ADR-0007). - Decide the CA question. Record it.
Purchases this needs
None.
Activity
docs(adr): renumber the second ADR-0041 to 0042, and fix README's two…
Merge pull request #505 from Gerrrt/gerrrt/jumpbox-ca-placement-0370a9
[-]Build a deployment jumpbox on ImaginationLAN, and decide where the CA lives[/-][+]Build phoenix, the deployment host on ImaginationLAN (ADR-0043)[/+]Gerrrt commentedon Sep 19, 2026
Build checklist, 2026-09-19
The repo half is split in two because
scripts/check_docs.pywill not let the**Not built yet**marker and anetwork.mdrow coexist, and the lab's ports must be open before the agent first pushes:stacks/labpublishes9090and3100). Merged 2026-09-19; apply it onalexanderin §5.network.mdrow, marker gone, "five Alloy agents",Saruman's guest count, the WAN note,observability.md, the roadmap, a §0 status block in the runbook). It merges only after §7 is green, and it is the one that closes this issue.Everything below is
build-the-jumpbox.md; the runbook has the commands. What each step needs reported back is so the docs can be exact.Saruman—qm create 170 …(ISO name frompvesm list local --content iso), Ubuntu Server with hostnamephoenix,10.0.30.70/24, gateway and DNS10.0.30.1, OpenSSH, no Docker. Report: build date, ISO filename, the OUI fromqm config 170 | grep net0(the first three octets only; the row masks the rest).morpheus— the Kea reservation for that MAC →10.0.30.70, under Services → DHCP Server → ImaginationLAN.Sarumanandphoenix— thepveumblock, then the onehost.fwline beneath ADR-0014's three (read the CAUTION first: if/etc/pve/nodes/saruman/host.fwdoes not exist, the firewall was never on). Onphoenix:~/.config/proxmox/phoenix.envat mode 600,ssh-keygen -t ed25519 -C phoenix,git clonethe repo. Run thecurlproof; report which of timeout / 401 / empty 200 / a list it gives. The token secret stays on that host and never enters a session transcript.alexander— feat(lab): prometheus and loki publish 9090 and 3100 on alexander for phoenix's agent (#436) #543 is merged:git pull && make up STACK=lab, thenss -ltn '( sport = :9090 or sport = :3100 )'. Report both lines.phoenix, then./scripts/deploy-agent.sh --runtime native --monitoring-host 10.0.30.40 <user>@10.0.30.70. Report the script's arrival check.make validateinphoenix's checkout; in the lab Grafana,up{instance="phoenix"}(expectphoenix-metricsandphoenix-alloy, both1) andcount by (job) (count_over_time({host="phoenix"} [15m]))(three jobs or more; two meansrsyslogis missing). Report the three results.Per the issue's "Done when", the runbook's §6 is the deploy proof: the agent lands on
phoenixbymake deploy-agentfrom the Mac, andphoenix's own checkout passesmake validate. No SSH trust fromphoenixto any other host is added.VLAN 30 is unreachable from the monitoring host and the lab Prometheus refuses
morpheus, so none of §1–§7 can be driven or verified from a session here; the reports above are what turns the draft PR into the merge that closes this.feat(lab): prometheus and loki publish 9090 and 3100 on alexander for…
docs: phoenix was created on Saruman on 2026-09-20 from the 26.04.1 s…
docs(runbook): phoenix's NIC carries the bc:24:11 OUI the network.md …
docs(runbook): PhoenixBuilder drops VM.Monitor, which Proxmox VE 8 re…
docs: the Proxmox node is Saruman, case and all, and its firewall was…
docs(runbook): phoenix's §7 passed — validate green, both jobs up, fo…
docs(runbook): phoenix's token lists both guests — §4 proven, no plac…
docs: phoenix is built at 10.0.30.70 on Saruman, the lab has its firs…
fix(deploy): make up passes on a stack with no Alertmanager, and the …