This document delineates the steps necessary to perform a clean installation of Proxmox Virtual Environment on a host device using a USB drive as the installation media.
This document assumes the device POSTs successfully with no errors and that the device meets the minimum requirements for Proxmox VE.
Step 1 – Creating Installation Media Using Etcher
To create the installation media, we will be assuming the USB drive will be flashed from a Microsoft Windows workstation or a Linux workstation with a distribution based on Debian/Ubuntu.
Download and install Balena Etcher from this link.
Download the desired version of the Proxmox VE installation ISO from this link.
Connect the USB drive to your workstation.
Select the USB drive from the drive list, then select the ISO to flash to the device.
Browse to and select the Proxmox VE installation ISO.
Click Flash! When done, you are ready to plug the USB drive into your intended host.
Step 2 – Booting to the USB Drive
Connect the USB drive to your intended host while it is powered off.
Immediately after power on and POST, we will need to boot from the USB drive. Every equipment manufacturer does this differnetly. For most Dell desktop systems, F12 will be the key to strike. For most HP desktop systems, F8 will be the key to strike. For most Lenovo desktop systems, Esc is the key to strike. Server hardware will vary from vendor to vendor as well.
Power on your intended host and use the appropriate keystroke to bring up the one-time boot menu, then select the USB drive.
Step 3 – Installation of Proxmox VE
Once the Proxmox GRUB installer loads, select Installation (Debug) and strike Enter on the keyboard. A black console screen will appear and the installer will check for attached installation media.
When the console gives the option to exit or strike Ctrl+D to continue installation, strike Ctrl+D.
Do note that you must use the debug install option first otherwise the installation will fail.
You may have to strike Ctrl+D a second time.
The screen will again display the Proxmox VE installer and move you through a series of prompts. Follow the prompts to assign timezone, select the hard disk device to which you’d like to install the system, configure host network settings, root user, etc.
When you reach the end of the installation process, you will be instructed to reboot the host and point another workstation’s web browser to the host URL, which will be the IPv4 address of the host on port 8006 using HTTPS. (Example: https://192.168.0.100:8006).
Step 4 – First Run
Once the host has rebooted, your web browser should be able to reach the web portal for your Proxmox host. Log in using the root credential you created during the installation process. The authentication type should be Linux PAM.
You are now able to configure your virtual environment with storage and start spinning up virtual machines and containers.
Additional information on installing the Proxmox Virtual Environment can be found here:
This document will delineate the steps necessary to work around a situation where your Proxmox cluster will not allow you to interact with it due to lack of quorum between the hosts.
This document assumes that the nodes in the cluster are all online with proper certificates, network connectivity, and that the administrator intents to properly resolve the quorum issue following these steps.
This guide is not intended to be a permanent solution, but rather a work-around.
This occurs when the cluster quorum is not configured correctly –or– when a cluster member is offline. The intended function of the cluster is to not work if the quorum does not receive the adequate number of votes from the cluster to begin. You can manually set the number of expected quorum.
Step 1 – Override expected number of quorum votes
You can manually set the number of expected quorum votes by running this command:
pvecm expected #
where # is the number of votes you wish to make the quorum use to determine if the cluster is quorate.
Only manually override this if the node that is offline is about to be deleted from the cluster.
Following use of this command, the cluster should achieve quorum and allow you to interact with it. It is recommended that you remove the problem node from the cluster following the procedure.
A brief how-to-fix for Proxmox community edition environments where nodes will not update packages successfully using apt-get.
A virtualization host/node running Proxmox (whether clustered or not) will fail to update packages via apt-get and produce the below error messages in the task queue:
Proxmox Virtualization Environment (confirmed for versions 6.2 and newer) running the free/community editions without and enterprise subscription.
The cause of this issue results from not having a Proxmox Enterprise subscription/license. These errors are caused by apt-get attempting to procure updates from the subscription enterprise proxmox repository, but because the node or cluster does not have a valid enterprise subscription, the update fails and produces an error.
Access the shell for the node/virtualization host producing the error and run the following command:
This command copies the repository sources list, renames the original as a backup so the system does not use it, then comments out the line of the list for the enterprise repository.
Once this command runs successfully, you should be able to either (a) wait for the scheduled updates to try to run again or (b) manually search for and install updates using apt-get update/upgrade. Either way, no errors should be produced.
And that’s it. Everything else will be handled during the install process.
Installing the Controller
To get the controller installed on Linux you have many options. Ubiquiti has some instructions on how to install the controller on their website but it only covers the install for a couple of specific versions of Linux. To use Debian, use the script that has been posted on the Unifi forums by member AmazedMender16.
To start the install, first ssh into the Debian server or access the server from the console. Log in either as root or as another user that has root access and then run su.
Update the apt repos.
Next, install the ca-certificates and wget packages.
Download and run the Unifi Controller installer script. This script will handle the install of the dependencies and controller software for many different distros of Linux including the Debian 10 server we are using.
You will be prompted for a few things while the script runs. First, it will ask if you want to keep the script downloaded after the install. In most cases this is not required, so you should enter n and then press enter.
Ensuring the Unifi controller software is kept up to date
You may receive a prompt to update packages during the install. Enter y and then press enter.
Confirming it’s OK to update packages
Finally, you will be prompted to add the apt repo for Unifi to update the controller from apt. Enter y and press enter as this will make upgrades serviceable through apt.
Adding the Unifi Network Controller repo to apt
Once the install completes, the script will output the version of the controller installed and the URL to use to start configuring the controller.
Configuring the Controller
Once you have the controller software installed on whatever server you are using the setting will be the same.
Go to the web address https://<ServerIP>:8443/ and you will be presented with the controller’s web portal.