diff --git a/web/app/docs/create-vm/system-windows/page.tsx b/web/app/docs/create-vm/system-windows/page.tsx index 015730f..2bf745c 100644 --- a/web/app/docs/create-vm/system-windows/page.tsx +++ b/web/app/docs/create-vm/system-windows/page.tsx @@ -284,6 +284,80 @@ export default function WindowsVMPage() { +
+

+ + Disk Selection +

+

+ Once the machine is configured, the script allows you to choose between two types of disks: +

+ +

Virtual Disk

+ + +

Physical Disk Passthrough

+ +
+ +
+

+ + Additional Features +

+ +

EFI Disk Configuration

+

+ When UEFI BIOS (OVMF) is selected, the script automatically configures an EFI system disk to ensure compatibility with modern bootloaders: +

+ +

+ For Windows systems, a TPM 2.0 device is also added automatically to meet installation requirements for modern versions like Windows 11 and Windows Server 2022. +

+ +

ISO Mounting

+

+ The script also handles ISO mounting automatically for both installation media and optional drivers: +

+ + + +

QEMU Guest Agent

+

The script automatically configures QEMU Guest Agent support:

+ +
+

Windows Installation Options

ProxMenux offers two methods for installing Windows on your virtual machine:

@@ -304,8 +378,9 @@ export default function WindowsVMPage() {

- The ProxMenux script UUP Dump ISO Creator allows you to download and create Windows installation media directly from Microsoft's Windows - Update servers. This option provides the latest Windows builds, including Insider Preview versions. + The UUP Dump ISO Creator script is a utility included in ProxMenux that allows you to + download and create Windows installation media directly from Microsoft's Windows Update servers. + This option provides access to the latest Windows builds, including Insider Preview versions.

Features:

@@ -317,15 +392,10 @@ export default function WindowsVMPage() {
  • Support for various Windows editions (Home, Pro, Enterprise)
  • -

    - - Learn more about UUP Dump ISO Creator - +

    + + Learn more about UUP Dump ISO Creator +

    diff --git a/web/app/docs/utils/UUp-Dump-ISO-Creator/page.tsx b/web/app/docs/utils/UUp-Dump-ISO-Creator/page.tsx new file mode 100644 index 0000000..e7f72c9 --- /dev/null +++ b/web/app/docs/utils/UUp-Dump-ISO-Creator/page.tsx @@ -0,0 +1,387 @@ +import type { Metadata } from "next" +import Link from "next/link" +import Image from "next/image" +import { ArrowLeft, Download, Package, Code, Server, Clock, ExternalLink } from "lucide-react" + +export const metadata: Metadata = { + title: "ProxMenux Documentation: UUP Dump ISO Creator", + description: + "Guide for using the UUP Dump ISO Creator utility in ProxMenux to download and create Windows installation media directly from Microsoft's Windows Update servers.", + openGraph: { + title: "ProxMenux Documentation: UUP Dump ISO Creator", + description: + "Guide for using the UUP Dump ISO Creator utility in ProxMenux to download and create Windows installation media directly from Microsoft's Windows Update servers.", + type: "article", + url: "https://macrimi.github.io/ProxMenux/docs/utilities/uup-dump-iso-creator", + images: [ + { + url: "https://macrimi.github.io/ProxMenux/utils/uup-dump-iso-creator.png", + width: 1200, + height: 630, + alt: "ProxMenux UUP Dump ISO Creator", + }, + ], + }, + twitter: { + card: "summary_large_image", + title: "ProxMenux Documentation: UUP Dump ISO Creator", + description: + "Guide for using the UUP Dump ISO Creator utility in ProxMenux to download and create Windows installation media directly from Microsoft's Windows Update servers.", + images: ["https://macrimi.github.io/ProxMenux/utils/uup-dump-iso-creator.png"], + }, +} + +interface ImageWithCaptionProps { + src: string + alt: string + caption: string +} + +function ImageWithCaption({ src, alt, caption }: ImageWithCaptionProps) { + return ( +
    +
    + {alt} +
    + {caption} +
    + ) +} + +export default function UUPDumpISOCreatorPage() { + return ( +
    +
    + +
    + +

    UUP Dump ISO Creator

    +
    + +
    +

    + The UUP Dump ISO Creator script is a ProxMenux utility that allows you to download and create Windows + installation media directly from Microsoft's Windows Update servers. This option provides access to the + latest Windows builds, including Insider Preview versions. +

    +
    +
    + + + +
    +

    What is UUP Dump?

    +

    + UUP Dump is a service that allows users to download Unified Update Platform (UUP) files directly from + Microsoft's Windows Update servers. These files can be converted into complete, official Windows installation + ISO images. +

    + +

    The main advantages of using UUP Dump include:

    +
      +
    • Access to the latest Windows versions, including Insider builds
    • +
    • Ability to download specific Windows versions that are no longer officially available
    • +
    • Obtaining clean, official ISO images directly from Microsoft's servers
    • +
    • Support for multiple Windows editions (Home, Pro, Enterprise, etc.)
    • +
    • Ability to select specific languages
    • +
    +
    + +
    +

    Script Functionality

    +

    + The ProxMenux UUP Dump ISO Creator script automates the entire process of downloading and creating Windows ISO + images. The main features of the script include: +

    + +
    +
    +
    + +

    Dependency Management

    +
    +

    + The script automatically verifies and installs all necessary dependencies for the download and conversion + process: +

    +
      +
    • + curl - For downloading files +
    • +
    • + aria2 - Advanced download manager +
    • +
    • + cabextract - For extracting CAB files +
    • +
    • + wimtools - For manipulating WIM files +
    • +
    • + genisoimage - For creating ISO images +
    • +
    • + chntpw - For modifying Windows registries +
    • +
    +
    +
    +                apt-get install curl aria2 cabextract wimtools genisoimage chntpw
    +              
    +
    +
    + +
    +
    + +

    Conversion Process

    +
    +

    + The script handles the entire process of converting UUP files to a bootable ISO image: +

    +
      +
    • Downloading the official UUP Dump converter script
    • +
    • Generating the file list to download based on the provided URL
    • +
    • Downloading all necessary files using aria2 (parallel download)
    • +
    • Converting the downloaded files to a bootable ISO image
    • +
    • Cleaning up temporary files after creation
    • +
    +
    + +
    +
    + +

    Proxmox Integration

    +
    +

    The script integrates seamlessly with the Proxmox VE environment:

    +
      +
    • Automatic detection of the ISO storage directory in Proxmox
    • +
    • Storage of the resulting ISO image in the correct location
    • +
    • Immediate availability of the ISO for use in VM creation
    • +
    • Compatibility with different Proxmox storage configurations
    • +
    +

    The script automatically detects the ISO storage directory in Proxmox by:

    +

    + If none is found, uses the default directory /var/lib/vz/template/iso +

    +
    + +
    +
    + +

    Download Process

    +
    +

    + The script uses aria2 to download files with optimized configurations. The typical processing time is + approximately 10 minutes, depending on your internet connection speed and server performance. +

    +
    +
    +                
    +                  aria2c --no-conf --console-log-level=warn --log-level=info --log="aria2_download.log" -x16 -s16 -j5 -c
    +                  -R -d"$destDir" -i"$tempScript"
    +                
    +              
    +
    +

    + Where: +
    + -x16: Maximum 16 connections per server +
    + -s16: Splits each file into 16 segments +
    + -j5: Downloads 5 files in parallel +
    + -c: Continues partial downloads if possible +
    + -R: Retries failed downloads +

    +
    +
    +
    + +
    +

    Step-by-Step Guide: Getting the UUP Dump URL

    +

    + Before using the UUP Dump ISO Creator script, you'll need to obtain a specific UUP Dump URL that contains the + necessary parameters (id, pack, edition). Follow these steps to generate the correct URL: +

    + +
    +
    +

    + + 1 + + Select Windows Version +

    +

    + Visit the UUP Dump website ( + + https://uupdump.net/ + + ) and select the Windows version you want to download. +

    + +
    + +
    +

    + + 2 + + Select Specific Build +

    +

    + Choose the specific Windows build you want to download. You can select from the latest builds, Insider + Preview builds, or specific versions. +

    + +
    + +
    +

    + + 3 + + Select Language +

    +

    + Choose the language for the Windows image. You can select any language available for that specific build. +

    + +
    + +
    +

    + + 4 + + Select Editions +

    +

    + Select the Windows editions you want to include in the ISO image. You can choose one or multiple editions + (Home, Pro, Enterprise, etc.). +

    + +
    + +
    +

    + + 5 + + Get Download URL +

    +

    + On the final page, you'll see download options. What you need is the URL that appears in your browser, + which should contain the parameters id,{" "} + pack, and{" "} + edition. +

    + +
    +
    +
    + +
    +

    Using the UUP Dump ISO Creator Script

    +

    + Once you have the UUP Dump URL, you can use the ProxMenux UUP Dump ISO Creator script to download and create + the ISO image: +

    + +
    +
    +

    + + 1 + + Paste the UUP Dump URL +

    +

    + When prompted, paste the complete UUP Dump URL you obtained in the previous steps. The script will verify + that the URL contains all the necessary parameters. +

    + +
    + +
    +

    + + 2 + + Start the UUP Dump ISO Creator Script +

    +

    Access the Utilities section in ProxMenux and select "UUP Dump ISO Creator".

    + +
    + +
    +

    + + 3 + + Process Completion +

    +

    + Once the process is complete, the script will display a success message and the location of the created + ISO image. The ISO will be immediately available for use in creating virtual machines in Proxmox. +

    + +
    +
    +
    + +
    + ) +}