• Build a fully customizable Proxmox VE 9 live boot ISO image.¹
• Supports persistence filesystems across reboots (if configured).
• Use it to test Proxmox VE without installing it.
• Or create a portable USB to run a live Proxmox VE system.
• Dual boot with Windows in a single SSD.
• Lightweight LXDE desktop environment preconfigured.

• Get the prebuild PVE-Live ISO here: Release page
• Or build your own: How to build

By default, the vmbr0 bridge obtains its IP from DHCP via ethernet.

If no ethernet cable is connected, you can use WiFi instead. To connect to WiFi, use wpa_supplicant and ifupdown2:

Replace SSID_NAME with your Wifi SSID name, WIFI_PASSWD with your WiFi password.

# Configure WiFi
wpa_passphrase "SSID_NAME" "WIFI_PASSWD" > /etc/wpa_supplicant/wpa_supplicant-wlan0.conf

# Establish the Wi-Fi connection
systemctl enable --now wpa_supplicant@wlan0

# Bring up the wlan0 interface and obtain an IP address via DHCP
ifup wlan0

To automatically connect to WiFi at boot, uncomment the auto wlan0 line in /etc/network/interfaces (requires a persistence filesystem to be configured beforehand).

Quick steps:

1. Create a new ext4 partition (on any drive: internal or external), label it persistence
2. Add a file persistence.conf with the content: / union to that partition

For detailed platform-specific instructions, see persistence-setup.md

1. Fork this repository to your GitHub account.

2. Customization (optional)

   • Hook scripts: config/hooks/normal/
   • Add files to the root filesystem: config/includes.chroot/

3. Navigate to the Actions tab and enable workflows.

4. Select the “Build ISO” workflow from the left sidebar.

5. Click the “Run workflow”, add a tag then click “Run workflow”.

6. Wait for the build to finish and the generated ISO will appear under:

   • Repo -> Actions -> Build ISO -> Artifacts.
   • Repo -> Release page.

Requirements:

• Debian 13
• Packages:

  apt update && apt install -y live-build git
  

Steps:

1. Clone the repository:

   git clone https://github.com/LongQT-sea/pve-live.git
   cd pve-live
   

2. Customization (optional)

   • Hook scripts: config/hooks/normal/
   • Add files to the root filesystem: config/includes.chroot/

3. Start the build:

   lb config && lb build
   

4. After building, rename the ISO:

   mv live-image-amd64.hybrid.iso proxmox-ve_9.0_lxde_live.iso
   

5. Cleanup before the next build:

   lb clean
   

This project redistributes Proxmox VE (Copyright © 2008–2026 Proxmox Server Solutions GmbH) under the AGPL-3.0 license.