32 Commits
Author SHA1 Message Date
Claude 9b339b33f1 Remove VM 102 (Windows); Windows runs on separate physical machine
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CTRZQmUSrYXFC6WkcypYPv
2026-06-28 03:03:03 +00:00
Claude f687bd4f54 Move GPU and USB PCIe passthrough to after OS install
GPU and VL805 PCIe card passthrough (Steps 11.4/11.4b) moved to after
Ubuntu install so noVNC console works during installation. Also corrects
the Display=none instruction to happen at the same time as GPU add.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CTRZQmUSrYXFC6WkcypYPv
2026-06-28 02:43:46 +00:00
Claude 6cca5f0bfb Fix cpuset values: sockets are interleaved (even=socket0, odd=socket1)
The generic awk detection command produced no output on this hardware
because lscpu column layout differed. Replace with hardcoded correct
values derived from actual lscpu -e output on the R730xd.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CTRZQmUSrYXFC6WkcypYPv
2026-06-28 01:32:03 +00:00
Claude 3798be5b99 Fix cpuset docs: add before first boot, no restart needed
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CTRZQmUSrYXFC6WkcypYPv
2026-06-28 01:10:37 +00:00
Claude d01fe4717d Document NUMA socket pinning for VM 100 (socket 0) and VM 101 (socket 1)
Add cpuset instructions so each VM is actually pinned to its physical CPU
rather than relying on Proxmox to guess. VM 100 → CPU 1 (socket 0),
VM 101 → CPU 2 (socket 1).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CTRZQmUSrYXFC6WkcypYPv
2026-06-28 01:05:26 +00:00
Claude f0fb4e00b4 Fix step ordering: create VM 101 before adding Coral USB, expand wizard detail
Move Coral USB passthrough to after VM 101 creation. Expand VM 101 wizard
to full tab-by-tab format matching VM 100 with NUMA, ballooning disabled,
VirtIO-GPU, and security VLAN network settings.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-28 00:51:35 +00:00
Claude 441cd4533b Update VM wizard docs with Proxmox 9 clarifications
- Graphic card: VirtIO-GPU is new name for Default in Proxmox 9
- Disk: 600 GiB, add IO thread, explain SSD emulation not needed
- Memory: disable ballooning for VM 100 (NUMA pinning), set min=max
- GPU PCI device: add ROM-Bar row, explain why it must stay checked
- OS version: 6.x kernel correct for Ubuntu 24.04

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-28 00:50:03 +00:00
Claude 5f10e2210b Document udev port-binding for two identical USB optical drives
Drives on VL805 card get stable /dev/optical-drive1 and /dev/optical-drive2
symlinks via port-based udev rules. Explains why vendor/device ID binding
fails for identical drives.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 17:37:00 +00:00
Claude da02e6eebe Add USB 3.0 PCIe card passthrough step for VM 100
VL805/VIA card at 82:00.0 passed to VM 100 (services) as PCIe device.
Coral TPU uses built-in server USB ports for VM 101 (Frigate).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 17:33:09 +00:00
Claude 93a2243af3 Add back-to-top navigation links between phases
Place <a href="#top">↑ Back to top</a> before each Phase heading
and at end of file for easy navigation in GitHub rendered view.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 17:18:08 +00:00
Claude fbb4f5588e Document NUMA and nested-virt in CPU tab for VM 100
- Add Enable NUMA row to CPU table
- Explain NUMA node pinning and cross-socket penalty
- Note nested-virt flag appears automatically with host CPU type
- Clarify NUMA checkbox location (Processors, not Memory dialog)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 17:15:52 +00:00
Claude 213d234841 Restructure VM layout: VM 100=services, VM 101=Frigate, VM 102=Windows
VM 100 is now the main services VM (Ubuntu Desktop, GPU, HDDs, Immich/Jellyfin/
Audiobookshelf/NAS). VM 101 is Frigate on a security VLAN with Coral USB.
VM 102 is Windows 11 for Sync.com. Updated all references throughout.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 17:08:39 +00:00
Claude 37a45259eb Disable Wayland system-wide, fix VM 100 install for Ubuntu Desktop
- Step 11.11: rewrite install steps for Ubuntu Desktop (not Server)
- Step 11.13: new step — sed one-liner to force Xorg via gdm3/custom.conf
- Step 11.14: add Wayland disable for VM 101, update VM 102 to Windows install
- Explain why Wayland breaks WinApps tsclient home drive sharing

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 16:55:15 +00:00
Claude 82827f9939 Add nested virtualization setup, drive discovery steps, and VM 102 Windows
- Step 11.6: enable nested KVM on Proxmox host (kvm-intel nested=Y)
- Step 11.7: find HDD by-id paths with lsblk and ls /dev/disk/by-id/
- Step 11.8: renamed from 11.6, drive passthrough unchanged
- Step 11.10: VM 102 Windows 11 for Sync.com with dedicated NTFS drive
- Renumbered steps 11.9-11.13 to accommodate new steps

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 15:59:16 +00:00
Claude afe9baf377 Fix Graphic card setting: use VirtIO during install, none after GPU passthrough
noVNC fails with 'Failed to run vncproxy' when Display is set to none and
no GPU is passed through yet — no virtual display exists to connect to.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 06:10:23 +00:00
Claude e8e9bd927a Add RAM MiB reference table and clarify raw drive passthrough
- Memory tab: 49152 MiB (48 GiB) with common GiB→MiB conversion table
- Drive passthrough: note that raw drives bypass Proxmox storage entirely

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 06:01:14 +00:00
Claude a2edf0359c Document QEMU Agent and TPM fields in VM System tab
- Set Graphic card to none (GPU passthrough VM)
- Add Qemu Agent row (check it, install guest agent post-install)
- Add TPM row (unchecked, only needed for Windows 11)
- Explain each setting

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:53:49 +00:00
Claude 9284d1dd10 Update VM 100 CPU/network wizard settings with E5-2660 v4 specifics
- Cores 8→12, add NUMA note for dual-socket E5-2660 v4
- Expand network table with VLAN Tag field and VirtIO note

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:51:57 +00:00
Claude fc78b2fc93 Add Write back cache explanation to VM disk setup
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:49:33 +00:00
Claude 08a0c17cd0 docs: clarify Graphic card setting for GPU passthrough VMs
VMs with a passed-through GPU need Graphic card set to 'none' —
VirtIO-GPU conflicts with the real card. VMs without GPU keep
default VirtIO for console access. Add this to VM 100 and VM 101
System tab tables with explanatory notes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:41:51 +00:00
Claude 2461cfd672 docs: move GPU from Frigate (VM 100) to Desktop (VM 101)
Coral handles Frigate detection; CPU decode is sufficient on dual Xeons.
GPU goes to VM 101 for Jellyfin/HandBrake/desktop use. Remove NVIDIA
driver install steps from Phase 12, renumber steps 12.2-12.14,
add notes on adding a second cheap GPU to VM 100 later if needed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:37:22 +00:00
Claude c0ac9c547e docs: add USB optical drive passthrough note
Recommend passing optical drives by port rather than vendor/device ID
due to re-enumeration during disc spin-up. Include lsusb -t discovery
and /dev/sr0 note for MakeMKV/HandBrake in VM 101.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:26:32 +00:00
Claude 0130cd22db docs: add generic USB passthrough section after Coral step
Covers passing any USB device to a VM by vendor/device ID or by port,
via both web UI and CLI, with notes on plug-in requirements and config management.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:23:39 +00:00
Claude d8bc1541f3 docs: update Ubuntu to 24.04.4, VM 101 to Desktop edition
Correct point release from 24.04.1 to 24.04.4 throughout.
VM 101 changed from Ubuntu Server to Ubuntu Desktop 24.04.4
for a full GUI workstation environment via noVNC/RDP.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:21:07 +00:00
Claude 2a6d7b9fea docs: update for single GPU (one P2200 at 04:00) 2026-06-27 05:08:27 +00:00
Claude 7c696c0125 docs: move drive-to-VM assignment to Phase 11 where VMs exist
Step 9.4 was telling users to fill in VM config placeholders before
VMs were created. Replace with a note to record by-id paths for use
in Phase 11 Step 11.6 where drives are actually assigned via qm set.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 05:01:01 +00:00
Claude b3aaf999d5 docs: remove Quadro P2200 specific references, generalize for any NVIDIA GPU
Replace all prose mentions of 'Quadro P2200' with generic GPU language.
Sample command output blocks left as-is (they're illustrative, not prescriptive).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:46:40 +00:00
Claude 76d7f43556 docs: update cmdline verification to use GRUB path
/etc/kernel/cmdline doesn't exist on GRUB-based installs.
Check grep CMDLINE /etc/default/grub instead, with EFI path as fallback.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:40:18 +00:00
Claude 05bcb747ae docs: consolidate to single README, move fan control to Phase 7 2026-06-27 04:35:19 +00:00
Outis 9061c0b907 Add setup guide for installation phases
Added a setup guide with detailed phases for installation.
2026-04-24 05:46:50 -04:00
Claude 017181c50a Add hardware layout docs and PERC H730 non-RAID setup script
Initial structure for R730xd passthrough configuration:
- README with VM layout table and setup order
- docs/hardware-layout.md: bay/GPU/USB mapping worksheet
- scripts/perc-nonraid.sh: convert H730 drives to per-disk non-RAID mode

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 00:56:05 +00:00
Outis 5bf0eba979 Initial commit 2026-04-23 19:52:41 -04:00