Commit Graph
53 Commits
Author SHA1 Message Date
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
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
Outis 0130fc7e62 Merge pull request #2 from outis1one/claude/proxmox-hardware-passthrough-ylAYx
Add detailed button-by-button walkthrough for phases 1-3
2026-04-24 05:46:19 -04:00
Claude 7bd7b8019d Add detailed button-by-button walkthrough for phases 1-3
Covers:
- What iDRAC is in plain English, and why no subscription is needed
- Phase 1: Firmware updates via Lifecycle Controller (F10), including
  how to find the Service Tag and download firmware from Dell's site
  if the server has no internet access
- Phase 2: iDRAC static IP, dedicated NIC port, IPMI over LAN enable,
  default password change, browser login walkthrough
- Phase 3: Every required BIOS setting with exact menu paths —
  VT-x, VT-d, SR-IOV, UEFI boot mode, HDD sequencing, C States

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 09:41:00 +00:00
Outis 62aa66aac3 Merge pull request #1 from outis1one/claude/proxmox-hardware-passthrough-ylAYx
Claude/proxmox hardware passthrough yl a yx
2026-04-24 05:35:44 -04:00
Claude d04a998d86 Add end-to-end setup guide (bare metal → running Frigate)
12-phase walkthrough covering:
- Firmware updates via Lifecycle Controller
- iDRAC + IPMI over LAN setup (required for fan control)
- BIOS settings checklist (VT-x, VT-d, UEFI mode)
- H730 RAID1 config for 2.5" OS drives, leaving 3.5" for non-RAID
- Proxmox VE 9.1 install and post-install (repo fix, tools, git clone)
- Script run order: perc-nonraid → bay-map → gpu-passthrough → fan/spinup
- VM creation and Frigate Docker+NVIDIA deployment
- Troubleshooting section for common passthrough failures

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 01:18:01 +00:00
Claude 273d6191bd Add VM config examples and Frigate NVR setup
vm-configs/:
- 100-frigate.conf.example: Frigate VM with Quadro P2200 #1, Coral USB, bays 1-8
- 101.conf.example: GPU VM with Quadro P2200 #2, bays 9-10
- 102.conf.example: Utility VM, bays 11-12

frigate/:
- docker-compose.yml: nvidia runtime + Coral USB passthrough, healthcheck
- config.yml: NVDEC hwaccel (preset-nvidia-h264), Coral USB detector,
  motion-based recording retain, per-object score thresholds

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 01:07:21 +00:00
Claude c0604be087 Mark perc-nonraid.sh as executable
https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 01:04:21 +00:00
Claude 889c38c143 Add staggered drive spin-up script and systemd unit
12x 3.5" HDDs spinning up simultaneously can spike ~240W, pushing a single
750W PSU close to its limit. Two-layer fix:
- Layer 1: racadm iDRAC BIOS setting (HddSeq) fires at POST before OS loads
- Layer 2: stagger-spinup.service wakes drives one at a time via hdparm on boot

https://claude.ai/code/session_01TxTSnxDjgEVuNztdsWQjMD
2026-04-24 01:04:02 +00:00