Proxmox (VM)

Basic installation finished?

Please read first the → Basic Installation!

Generate a new Proxmox VM

  1. Access the Proxmox web interface via HTTPS on TCP port 8006:
    • URL:https://<your.IP>:8006
    • Username: root
    • Password: <root user password you entered during Proxmox VE install>
  2. Tab General: Select the Create VM button at the top right corner. Choose a Node, a VM ID and a Name, then click Next.

    Proxmox VM creation

    Remember the VM ID, you need it later.

  3. Tab OS: Select “Do not use any media “, for the Guest OS assure that Linux and version “5.x - 2.6 Kernel” is selected, then click Next.
  4. Tab System: As Machine you can select q35, but the older default will work as well. We recommend the para-virtualised VirtIO SCSI controller, which should be the default. Click Next.
  5. Tab Disks: Delete the default scsi0 disk with the red trash bin button, then click Next.
  6. Tab CPU: Adjust CPU details as required, we recommend to use the default kvm64 type. Then click Next.
  7. Tab Memory: While DietPi runs with less, depending on the software you want to install and run within the VM, we recommend at least 1024 MiB memory size, 2048 MiB allows the DietPi system to setup itself without a swap file by default. When done, click Next.
  8. Tab Network: Using a network bridge allows the VM to show up as dedicated system in your LAN, which simplifies SSH and network application access. We recommend to use the default para-virtualised VirtIO adapter model. When done, click Next.
  9. Tab Confirm: Start the VM creation by clicking Finish.

Download, extract and import the DietPi image

Transferring a disk image to Proxmox: A DietPi disk image can be transferred to the Proxmox server via e.g. USB flash drive or by uploading it as CD/DVD ISO image. Since the import needs to be done via console (accessible via web interface and SSH), we guide you through the path of downloading it directly on the Proxmox server.

  1. Select the Proxmox node, then click the Shell button at the top right corner. Alternatively connect via SSH to the Proxmox server, using the same login credentials you used for the Proxmox web interface.
  2. In the console window, enter the following commands to download the DietPi image, extract it via p7zip, import it as disk to your new VM (using the VM ID you chose during creation) and make it the boot drive.
    If not done yet, we recommend to upgrade all APT packages to the latest version.
    apt update
    apt full-upgrade
    apt install xz-utils
    curl -O https://dietpi.com/downloads/images/DietPi_Proxmox-x86_64-Bullseye.xv
    xv -d DietPi_Proxmox-x86_64-Bullseye.xv

    Optionally verify the SHA256 hash of the downloaded file via:

    sha256sum -c < <(mawk '/SHA256/{print $2"  DietPi_Proxmox-x86_64-Bullseye.qcow2"}' hash.txt)

    As next, the disk image is imported.
    Note: Replace 100 below with the VM ID entered during VM creation.

    ID=100
    qm importdisk "$ID" DietPi_Proxmox-x86_64-Bullseye.qcow2 local-lvm
    qm set "$ID" --scsi0 "local-lvm:vm-$ID-disk-0"
    qm set "$ID" --boot order=scsi0
  3. Finally, you can remove the downloaded and extracted files and close the console:
    rm DietPi_Proxmox-x86_64-Bullseye.* hash.txt README.md

The VM can now be started, select it via left side navigation of the Proxmox web interface, then the Start button at the top right side, finally the Console button to watch and finish the DietPi first run setup.

Alternatively you can connect to the VM via SSH, after giving it some time to finish initial setup steps and obtaining its IP with your router or IP scanner.

Proxmox VM starting

Continue with LoxBerry Installation