| 1 | # Isolated host rehearsal |
| 2 | |
| 3 | Normal service and dashboard previews run on Snow Globe. Use the optional NixOS |
| 4 | VM only when a change needs an isolated host, OS, storage, or guest boundary. |
| 5 | It has no production GPU; do not download model weights or enable inference. |
| 6 | |
| 7 | The VM configuration is `nixos/vm.nix` (flake `vm`), with hostname `snowglobe-rehearsal`, |
| 8 | domain `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 |
| 12 | SNOWGLOBE_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`. |
| 19 | Those media bytes are personal source data, not synthetic fixtures. The VM's |
| 20 | own Clover dataset is separate. Use disposable test data and do not inspect |
| 21 | private source contents without authorization. |
| 22 | |
| 23 | Use the configured DNS and TLS routing for the VM. Do not hand-edit host files, |
| 24 | DNS, or trust to bypass a failed setup. Keep VM console/browser checks inside the |
| 25 | normal browser panel. Rehearsal evidence belongs in its relevant runbook; the |
| 26 | primary agent workflow remains staging on Snow Globe. |