Commit Graph
61 Commits
Author SHA1 Message Date
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 132c55e4e1 Add attach-drives.sh: auto-generate qm set commands for data drives
Scans /dev/sd?, skips OS drive (sda) and USB sticks (<100 GiB), checks
which drives are already attached to any VM, then prints (or applies with
--apply) the qm set commands for the next free scsi slot on the target VM.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CTRZQmUSrYXFC6WkcypYPv
2026-06-28 01:03:22 +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 89f8a453b7 fix: perc-nonraid.sh add JBOD controller enable and per-drive JBOD state
H730 requires two steps: enable JBOD on the controller, then set each
UGood drive to JBOD state. Without both, drives show in perccli but
are invisible to lsblk/the OS. Also skip Onln drives (OS RAID members).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:58:31 +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
Claude af9d418856 docs: in-progress consolidation edits to complete-walkthrough.md
Partial commit to satisfy pre-push hook — agent restructure in progress.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:33:44 +00:00
Claude 47a56e5745 docs: fix perccli install in all walkthrough docs
Replace stale Dell tar.gz URL and deb extraction method across
complete-walkthrough.md and walkthrough-phases-7-9.md with the
working method: curl with referer header to get RPM, convert with
alien, symlink binary into PATH.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:27:37 +00:00
Claude 63dd22b250 docs: document working perccli install method for Proxmox
apt and direct Dell URLs don't work. Working method: curl with referer
header to get the RPM, convert with alien, symlink binary into PATH.
Update both setup-guide and perc-nonraid.sh error message to match.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:20:20 +00:00
Claude d05805a9d7 docs: add missing service file copy and chmod to stagger-spinup setup
Without cp stagger-spinup.service to /etc/systemd/system/ the enable
step fails with 'unit does not exist'. Also add missing chmod +x.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 04:03:50 +00:00
Claude 2e141884a9 fix: perccli install — prefer apt, remove stale Dell download URL
The hardcoded dl.dell.com tarball URL is stale and returns a redirect.
Suggest 'apt install perccli' first (available in Proxmox repos), then
fall back to manual .deb download via dell.com/support with service tag.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 03:59:56 +00:00
Claude 95ea951741 fix: remove iDRAC HddSeq dependency removed in BIOS 2.19+
BIOS.StorageSettings.HddSeq no longer exists on R730xd firmware 2.19+.
Update --idrac mode to print a clear explanation instead of failing,
and update docs to skip Layer 1 and go straight to the Linux systemd service.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 03:57:54 +00:00
Claude a2df96ccef fix: gpu-passthrough-setup handle GRUB when proxmox-boot-tool absent
Fall through to /etc/default/grub + update-grub when /etc/kernel/cmdline
doesn't exist, instead of erroring out. Covers systems that booted via
legacy GRUB rather than the Proxmox EFI boot tool.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 03:49:24 +00:00
Claude 7067b53e09 docs: fix apt repo setup for Proxmox 9 (trixie)
PVE9 uses .sources (DEB822 format) not .list files for enterprise repos.
Update distro codename from bookworm to trixie, add ceph-squid
no-subscription repo, and disable both .sources and .list variants
to cover all cases.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 03:39:23 +00:00
Claude c2ca356088 docs: fix Phase 3 BIOS table for newer R730xd firmware
VT for Direct I/O toggle and Hard Disk Drive Sequencing were removed
from BIOS 2.19+; VT-d is enabled by default. Add dmesg verification
step and clarify C-states should be disabled. Remove outdated note
pointing users to a nonexistent menu option.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 01:46:53 +00:00
Claude 40fe95dec2 docs: update Phase 3 BIOS paths for firmware 2.19.0
Dell R730xd BIOS 2.19.0 renamed settings and reorganized menus:
- "VT for Direct I/O" → "Virtualization Technology for Direct I/O" (same page, scroll down)
- "Power Management" top-level category → "System Profile Settings"
- "Power Management Policy: Performance" → set System Profile to Custom, then CPU Power Management to Maximum Performance
- Add inline note so future readers know why the labels differ from older docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-27 01:14:00 +00:00
Outis 1235d1c514 Merge pull request #6 from outis1one/claude/affectionate-hawking-rHQ37
Complete phases 11-12 walkthrough and add single-document combined guide
2026-05-22 14:10:20 -04:00
Claude deb7dc6d48 Complete phases 11-12 walkthrough and add single-document combined guide
Writes the missing Phase 11 (VM creation via Proxmox UI, GPU/Coral/disk
passthrough, Ubuntu install) and Phase 12 (NVIDIA driver, Docker, NVIDIA
Container Toolkit, ZFS pool, Frigate deploy) sections in the existing
walkthrough-phases-10-12.md, then assembles all 12 phases into a single
docs/complete-walkthrough.md with a table of contents and an expanded
troubleshooting section covering guest nvidia-smi failures and ZFS disk-full.

https://claude.ai/code/session_01Mfn4vyaz7wkaDKX7E1VnWc
2026-05-22 18:05:52 +00:00
Outis 122b1604e3 Merge pull request #5 from outis1one/claude/proxmox-hardware-passthrough-7vPUg
Add Phase 10 walkthrough: fan control and stagger spin-up services
2026-04-24 17:42:37 -04:00
Claude 16ad3abe2a Add Phase 10 walkthrough: fan control and stagger spin-up services
Covers installing fan-control.sh + systemd service (replacing iDRAC's
100% fan response to non-Dell GPUs), configuring iDRAC BIOS hard disk
drive sequencing via racadm, and the Linux-layer stagger-spinup service
as a safety net. Phases 11 and 12 stubbed as placeholders.

https://claude.ai/code/session_01U7bSqj83VPbMZ9L8LTYa41
2026-04-24 21:40:07 +00:00
Outis e78a3ec0bc Merge pull request #4 from outis1one/claude/proxmox-hardware-passthrough-ylAYx
Add detailed button-by-button walkthrough for phases 7-9
2026-04-24 16:47:18 -04:00
Claude 677a85e908 Add session hand-off document
Summarises hardware, all repo files and their status, what still needs
to be written (walkthrough-phases-10-12.md and complete-walkthrough.md),
detailed notes on what phases 10-12 should cover, and key facts/gotchas
for whoever picks this up next.

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 20:46:23 +00:00
Claude 45a14483ca Add detailed button-by-button walkthrough for phases 7-9
Phase 7 — H730 non-RAID conversion:
- perccli download with direct Dell URL and manual fallback
- Script output explained column by column (EID:Slt, State, Size)
- What JBOD vs UGood vs Onln states mean
- Post-reboot verification with lsblk

Phase 8 — Bay mapping:
- build-bay-map.sh output walkthrough
- Physical LED blink procedure (ledctl locate/locate_off per drive)
- Bay numbering convention on R730xd front panel
- How to fill in hardware-layout.md and VM config placeholders

Phase 9 — GPU passthrough:
- Pre-check: dmesg IOMMU confirmation, IOMMU group inspection
- Script output walkthrough step by step
- PCI address capture and immediate VM config update
- Post-reboot verification (must show vfio-pci not nouveau)
- Troubleshooting if wrong driver appears

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 14:48:14 +00:00
Outis 46acd2677c Merge pull request #3 from outis1one/claude/proxmox-hardware-passthrough-ylAYx
Claude/proxmox hardware passthrough yl a yx
2026-04-24 05:51:28 -04:00
Claude 376a328ac4 Correct iDRAC section: server has Express not Enterprise
- Clarify iDRAC8 Express vs Enterprise with explicit feature table
- Remove incorrect claims (virtual console, virtual media) that require Enterprise
- Note physical monitor + keyboard required through Phase 5 (no remote KVM on Express)
- Confirm IPMI over LAN and racadm are available on Express (fan control and
  stagger spinup scripts both work)
- Update "what you need" list to correctly state monitor is required until Phase 6

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 09:50:33 +00:00
Claude cfa323e9af Add detailed button-by-button walkthrough for phases 4-6
Phase 4 — H730 RAID configuration:
- Lifecycle Controller navigation to RAID Configuration
- Identifying 2.5" OS drives vs 3.5" data drives by size
- Clearing foreign configurations if drives have prior RAID history
- Full VD creation wizard with every screen described
- Fast Initialize and verification

Phase 5 — Proxmox install:
- ISO download from proxmox.com
- USB creation for Windows (Rufus, DD mode), Mac (Etcher), Linux (dd)
- F11 UEFI boot menu navigation
- Every installer screen with what to type/select
- Certificate warning walkthrough, subscription nag explained

Phase 6 — Post-install:
- SSH connection
- Repo fix (enterprise → no-subscription community)
- apt dist-upgrade
- Tool installation with explanation of what each does
- Repo clone to /opt/local_proxmox

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 09:47:51 +00:00