1# Isolated host rehearsal
2
3Normal service and dashboard previews run on Snow Globe. Use the optional NixOS
4VM only when a change needs an isolated host, OS, storage, or guest boundary.
5It has no production GPU; do not download model weights or enable inference.
6
7The VM configuration is `nixos/vm.nix` (flake `vm`), with hostname `snowglobe-rehearsal`,
8domain `snowglobe.test`, and a demo pool. Its SSH endpoint is
9`root@127.0.0.1`, port `2222`. Both deployment overrides are required:
10
11```sh
12SNOWGLOBE_DEPLOY_HOST=root@127.0.0.1 SNOWGLOBE_DEPLOY_PORT=2222 python3 tools/deploy.py stage <service>
13```
14
15`tools/local-vm.sh` launches the VM. `SNOWGLOBE_VM_CACHE_DIR` overrides its cache;
16`SNOWGLOBE_VM_HEADLESS=1` selects background operation. Installed mode mounts
17`SNOWGLOBE_VM_MEDIA_SOURCE` (default `/Volumes/media`) read-only through 9P at
18`/mnt/media-source`, with a bindfs view at `/srv/clover/Media`.
19Those media bytes are personal source data, not synthetic fixtures. The VM's
20own Clover dataset is separate. Use disposable test data and do not inspect
21private source contents without authorization.
22
23Use the configured DNS and TLS routing for the VM. Do not hand-edit host files,
24DNS, or trust to bypass a failed setup. Keep VM console/browser checks inside the
25normal browser panel. Rehearsal evidence belongs in its relevant runbook; the
26primary agent workflow remains staging on Snow Globe.