Build and Release / build-sign-package (push) Waiting to run

Details

feat: Add professional hierarchical documentation

- Created comprehensive README.md with Mermaid diagrams, badges, and TOC
- Added docs/ directory with 7 sections and 14 markdown files
- Included architecture diagrams, flowcharts, and sequence diagrams
- All documentation is fully interlinked with cross-references
- Added ISO storage location on Proxmox development server
- Included troubleshooting guide and evaluation management docs
- All config files (Packer, Terraform, Ansible, Forgejo) documented
- Added icons and visual elements throughout documentation

2026-02-06 14:47:15 +00:00

4.7 KiB

Raw Blame History

💿 ISO Requirements

Storage Location

All ISO files must be placed on the Proxmox development server at:

/mnt/pve-07-iso-nvme/template/iso/

Verify Storage Path

# SSH to Proxmox host and verify
ssh root@la-vmh-07
ls -la /mnt/pve-07-iso-nvme/template/iso/

Required Files

✅ Mandatory

File	Description	Size	Notes
`CLIENT_LTSC_EVAL_x64FRE_en-us.iso`	Windows 11 LTSC 2024 Evaluation	~5.5 GB	Primary OS image
`virtio-win.iso`	VirtIO Drivers	~500 MB	Required for I/O performance

📁 Optional

File	Description	Use Case
`SERVER_EVAL_x64FRE_en-us.iso`	Windows Server 2022 Evaluation	Server deployments
`26100.1742.240906-0331.ge_release_svc_refresh_CLIENT_LTSC_EVAL_x64FRE_en-us.iso`	Windows 11 LTSC Update	Latest build

ISO Manifest

# Current directory contents
/mnt/pve-07-iso-nvme/template/iso/
├── CLIENT_LTSC_EVAL_x64FRE_en-us.iso           ✅ Required
├── SERVER_EVAL_x64FRE_en-us.iso                📁 Optional
├── debian-live-13.2.0-amd64-gnome.iso          📁 Linux (not used)
├── virtio-win.iso                              ✅ Required
└── 26100.1742.240906-0331...iso                📁 Optional (alternate)

Download Sources

Windows 11 Enterprise

Property	Value
Product	Windows 11 Enterprise LTSC 2024
Edition	Enterprise (Evaluation)
Architecture	64-bit (x64)
Language	English (US)
Download URL	Microsoft Eval Center

Windows Server 2022

Property	Value
Product	Windows Server 2022
Edition	Standard/Evaluation
Architecture	64-bit (x64)
Download URL	Microsoft Server Landing

VirtIO Drivers

Property	Value
Product	VirtIO Drivers for Windows
Source	Fedora/VirtIO-Win Project
Download URL	GitHub Releases

Download Steps

1. Download Windows 11 LTSC

# Visit Microsoft Eval Center
# Select: Windows 11 Enterprise LTSC 2024
# Architecture: 64-bit
# Language: English (US)
# Download ISO

2. Download VirtIO Drivers

# Download latest stable ISO
wget https://github.com/virtio-win/virtio-win-pkg-scripts/releases/download/v1.1.5/virtio-win-0.1.240-1.iso
mv virtio-win-0.1.240-1.iso virtio-win.iso

3. Upload to Proxmox

# Upload ISO to Proxmox storage
# Method 1: Via Proxmox GUI
# Datacenter -> Storage -> ISO -> Upload

# Method 2: Via command line
scp CLIENT_LTSC_EVAL_x64FRE_en-us.iso root@la-vmh-07:/mnt/pve-07-iso-nvme/template/iso/
scp virtio-win.iso root@la-vmh-07:/mnt/pve-07-iso-nvme/template/iso/

Configuration in Packer

Reference these ISOs in your Packer configuration:

# packer/windows.pkr.hcl

source "proxmox-iso" "windows-11" {
  # Primary OS ISO
  iso_file = "local:iso/CLIENT_LTSC_EVAL_x64FRE_en-us.iso"
  
  # VirtIO Drivers as secondary CD
  additional_iso_files {
    device   = "sata1"
    iso_file = "local:iso/virtio-win.iso"
  }
}

ISO Verification

Check File Integrity

# On Proxmox host
ls -lh /mnt/pve-07-iso-nvme/template/iso/

# Expected output:
# -rw-r--r-- 1 root root 5.5G Feb  6 10:50 CLIENT_LTSC_EVAL_x64FRE_en-us.iso
# -rw-r--r-- 1 root root 500M Feb  6 10:50 virtio-win.iso

Verify in Proxmox GUI

Navigate to Datacenter → Storage → ISO
Confirm files are listed and Content shows correct ISOs
Verify Available status is ✅

Troubleshooting

Issue	Cause	Solution
ISO not found	Wrong storage path	Verify `/mnt/pve-07-iso-nvme/template/iso/`
Mount failed	ISO corrupted	Re-download and verify checksum
VirtIO not loading	Wrong driver location	Check `additional_iso_files` path

Next Steps

Goal	Next Document
Configure secrets	Secret Management
Build template	Packer Configuration
View architecture	Architecture Overview

← Documentation Index | → Secret Management | ← Architecture

4.7 KiB Raw Blame History