3 minute read


This guide will show you how to perform the initial configuration of a fresh install of Proxmox VE, version 6.3-3 at the time of writing.

This guide assumes knowledge of vim and basic Linux administration. It also assumes that you have installed the OS as a ZFS filesystem.

It’s absolutely critical that the PVE OS was installed as a UEFI OS. Usually in the boot menu in the BIOS/UEFI menu, it will show the installer USB disk as UEFI: <Installer USB Drive>

If you need help with the installation of Proxmox VE, you can check out the previous setup post here.

Sometimes you may boot into an (initramfs), run these commands: zpool import -R / rpool then exit.

At this time, browse to: https://<pve-ip:8006>

Verify UEFI Boot and OS Version

Check to see that PVE has in fact booted into UEFI mode:

efibootmgr -v

Look for something along these lines:

BootCurrent: 0007
Boot0007* UEFI OS	HD(2,GPT,<disk-uuid>)/File(\EFI\BOOT\BOOTX64.EFI)..BO

Check the installed version (Should read at least 6.3-X):


Enable No-Subscription Repository

Proxmox VE No-Subscription Repository Documentation

  1. Login to the pve hypervisor:

     ssh root@<pve-ip>
  2. Enable the No-Subscription repositories

     # vi /etc/apt/sources.list


     deb http://ftp.us.debian.org/debian buster main contrib
     deb http://ftp.us.debian.org/debian buster-updates main contrib
     # security updates
     deb http://security.debian.org buster/updates main contrib


     deb http://ftp.us.debian.org/debian buster main contrib
     deb http://ftp.us.debian.org/debian buster-updates main contrib
     # PVE pve-no-subscription repository provided by proxmox.com,
     # NOT recommended for production use
     deb http://download.proxmox.com/debian/pve buster pve-no-subscription
     # security updates
     deb http://security.debian.org buster/updates main contrib

    Save and exit.

  3. Disable Proxmox VE Enterprise Repository

     vi /etc/apt/sources.list.d/pve-enterprise.list


     deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise


     # deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise

    Save and exit.

  4. Run update and install basic tools

     apt update
     apt update && apt install vim tmux parted
  5. Upgrade PVE OS Packages

     apt upgrade
     apt dist-upgrade

Nested Virtualization

Enable Nested Hardware-assisted Virtualization

Make sure that there are no running VMs at this time.

  1. Check to see if it has been enabled. At this point it should show N

     cat /sys/module/kvm_intel/parameters/nested
  2. Add the Nested Virtualization Kernel Module

    Only run one of these commands below

    If you have an Intel processor:

     echo "options kvm-intel nested=Y" > /etc/modprobe.d/kvm-intel.conf

    If you have an AMD processor:

     echo "options kvm-amd nested=1" > /etc/modprobe.d/kvm-amd.conf
  3. Load the Kernel Module

     modprobe -r kvm_intel
     modprobe kvm_intel
  4. Verify that it has been enabled. Should show Y

     cat /sys/module/kvm_intel/parameters/nested

Install Cloud-Init


At this point, let’s just install cloud-init, more information can be found in another post.

  1. Install package

     apt install cloud-init

(Optional) ZFS Imports

Most PVE hypervisors are configured to use disks as VM/Container storage, but in this case we want to use additional ZFS Pools for data storage that can be mounted/shared with VMs and Containers.

  1. If no pools have been created, follow the instructions here.
  2. Import pools

     zpool import -f <pool-name>
  3. Enable ZFS Scan and import services on boot

    Enable zfs import services:

     systemctl enable zfs-import-scan.service
     systemctl enable zfs-import.target

    Update initramfs:

     update-initramfs -u -k all

(Optional) Install NFS Server

Most guides recommend using an external NFS server or appliance OS, which is preferred if running as a PVE Cluster as it allows for migration across hypervisors.

This guide configures the hypervisor as an all-in-one server.

Here’s how to install and configure NFS Server:

  1. Install NFS Server

     apt update
     apt install nfs-common nfs-kernel-server
  2. Configure Server

     vim /etc/exports

    Add NFS exports (shares) to end of the file:

     <share-path> <network, e.g.>/,no_root_squash,subtree_check)
  3. Export and check setup:

    Export all shares:

     exportfs -a

    List all shared mounts:

     showmount -e <ip-of-pve-host>

(Optional) Add Networking Tools

If there is a need to add additional networks to the PVE hypervisor, install these packages

  1. Install these packages

     apt install ifupdown2 tcpdump
  2. Configure secondary network bridge

    Navigate to <pve-hostname>, System, Network, Create, Linux Bridge

    Add the following:

     IPv4/CIDR: <subnet-to-add>/24
     Bridge ports: <bridge-interface>

    Be sure to NOT add the gateway

  3. Click Apply Configuration

(Optional) Install Dark Theme

Dark Theme

Install the Dark Theme like this:

# Oneliner
bash <(curl -s https://raw.githubusercontent.com/Weilbyte/PVEDiscordDark/master/PVEDiscordDark.sh ) install

# OR manual
wget https://raw.githubusercontent.com/Weilbyte/PVEDiscordDark/master/PVEDiscordDark.sh

bash PVEDiscordDark.sh install

[~] PVEDiscordDark Utility

[I] Install theme
[Q] Exit

>? I

[~] PVEDiscordDark Utility

Backing up index template file..
Downloading stylesheet..
Downloading patcher..
Applying stylesheet and patcher..
Downloading images [22/22]..

Theme installed successfully!
Press [ENTER] to go back. <ENTER>

[~] PVEDiscordDark Utility

[I] Install theme
[U] Uninstall theme
[Q] Exit

>? Q

Final Steps

After performing all the selected steps above, reboot the machine and verify that everything is set up correctly.