Proxmox VE – Initial Installation & Setup Guide

Building a fast, reliable, and lightweight hypervisor using dedicated test hardware.

Welcome to the Proxmox VE installation guide at Realm Labs! Everything here is built, tested, and documented from real experience. In this guide, we will walk through setting up Proxmox Virtual Environment (PVE) from scratch—from bare-metal installation to post-install optimization using community helper scripts.

🖥️ Test Lab Hardware: The Shuttle DS81

Before committing full-scale server rack hardware to a homelab, it is always best practice to prototype on a dedicated test node. For this build and testing phase, we used a compact Shuttle DS81:

  • CPU: Intel Core i5
  • RAM: 16GB DDR3
  • Form Factor: Ultra-Small Form Factor (USFF) Slim PC

💡 Performance Verdict

Despite its small footprint and modest specs, the Shuttle DS81 performed exceptionally well as a test hypervisor. With 16GB of RAM and 4 cores / 4 threads, it effortlessly handled multiple unprivileged LXC containers (such as Pi-hole, Docker hosts, and lightweight Linux VMs) with minimal idle power consumption and dead-silent thermals. It is proof that you don’t need multi-thousand-dollar enterprise hardware to run a capable Proxmox lab.

🛠️ Step 1: Preparing Boot Media & BIOS Settings

1. Download Proxmox VE

Head over to the official website and download the latest Proxmox VE ISO Installer.

2. Flash to a USB Drive

Use a bootable USB utility like Ventoy or Rufus (DD mode recommended) to flash the ISO onto a USB flash drive (8GB+).

3. Configure the BIOS/UEFI on the Shuttle DS81

  1. Insert the USB drive and power on the Shuttle DS81.
  2. Tap F2 or Delete to enter the BIOS settings.
  3. Enable Intel VT-x (Virtualization Technology) and VT-d under CPU Configuration.
  4. Set the boot order to prioritize your USB installation drive.
  5. Save changes and reboot.

📦 Step 2: Bare-Metal Proxmox VE Installation

  1. Select Install Proxmox VE (Graphical) from the boot menu.
  2. Target Harddisk: Choose your primary SSD/NVMe drive. (For standard test nodes, ext4 or xfs works great; use ZFS if you have redundant drives).
  3. Location & Time Zone: Select your Country, Time Zone, and Keyboard Layout.
  4. Administrator Password & Email: Set a strong root password and enter a valid email address for system alerts.
  5. Network Configuration:
    • Management Interface: Select the primary ethernet NIC.
    • Hostname (FQDN): e.g., pve-test.realmlabs.internal
    • IP Address: Assign a static IP outside your router’s DHCP range (e.g., 192.168.1.50/24).
    • Gateway & DNS: Enter your local router IP (e.g., 192.168.1.1).
  6. Review the summary and click Install.
  7. Once finished, remove the USB drive and reboot.

🌐 Step 3: Accessing the Web Interface

Once booted, the terminal screen will display your management URL:

Plaintext

https://192.168.1.50:8006/
  1. Open your web browser and navigate to your assigned IP on port 8006 using https://.
  2. Accept the self-signed SSL security certificate warning.
  3. Log in with:
    • Username: root
    • Password: (The password set during installation)
    • Realm: Linux PAM standard authentication

⚡ Step 4: Post-Install Configuration & Helper Scripts

Are you allowed to use Proxmox VE Helper-Scripts?

Yes, absolutely! The Proxmox VE Helper-Scripts (originally created by the late tteck and now actively maintained by the open-source community) are fully permitted, widely respected, and open-source. Proxmox VE itself is open-source (AGPLv3), and community scripts interact directly with official Proxmox APIs and standard Debian utilities. Using them is standard practice across the homelab community for post-install maintenance and rapid LXC deployment.

Running the Post-Install Cleanup Script

By default, Proxmox VE enables the enterprise repository (which requires a paid subscription) and displays a subscription nag popup upon login. The post-install helper script automatically fixes this for homelab users.

  1. In the Proxmox Web UI, select your node (pve-test), open the Shell, and paste the following command:

Bash

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/post-pve-install.sh)"
  1. Follow the interactive prompts to:
    • Disable the Enterprise Repository.
    • Enable the No-Subscription Repository.
    • Correct the Test/Ceph Repositories.
    • Remove the “No Subscription” notice popup on login.
    • Update all system packages to the latest versions.

🚀 Next Steps

With Proxmox VE successfully installed on your Shuttle DS81 test node, your base hypervisor is ready! From here, you can start spinning up isolated containers and virtual machines:

  • Docker & Container Deployment: Learn how to run Docker inside an LXC container.
  • Windows & Active Directory Lab: Deploy Windows Server and client nodes.