How to install Proxmox VE on bare metal servers

You will install Proxmox VE 8.2 on bare metal hardware to create a private cloud capable of running KVM virtual machines and LXC containers. These steps target a fresh Debian 12 base system with Proxmox VE 8.2.0 installed from the official ISO.

Prerequisites

• Physical server or PC with at least 8 GB RAM and 50 GB free disk space.
• Proxmox VE 8.2 ISO image downloaded from the official website.
• Network cable connected to a router or switch with DHCP or static IP configuration available.
• BIOS/UEFI set to boot from USB or network PXE.
• Root access to the installation media or remote console (IPMI/iDRAC).

Step 1: Boot from the Proxmox ISO

Insert the Proxmox VE 8.2 installation USB into the server and restart the machine. Access the BIOS or UEFI settings to change the boot order so the USB drive is first. Select the USB drive from the boot menu if the system does not auto-boot.

Once the installer loads, select Graphical install to start the setup wizard. Choose your preferred language, keyboard layout, and time zone. Confirm the installation type as Debian 12 with the Proxmox packages.

Step 2: Configure the Network Interface

Select the network interface you want to use for management traffic. If your server has multiple NICs, choose the one connected to your primary network. Ensure the interface is set to DHCP for automatic IP assignment or enter a static IP manually.

Choose to configure the network via DHCP. The installer will assign an IP address like 192.168.1.10. You will see a prompt asking if you want to configure a second interface for storage or backup traffic. Select No for now to keep the setup simple.

Step 3: Create a Root Password

Set a strong root password when prompted. This password is required for SSH access and the web interface login. Do not use a weak password like "password123" as it compromises your security.

Confirm the password by typing it again. The installer will display a warning about the password strength. Accept the warning if you have chosen a complex password with uppercase, lowercase, numbers, and symbols.

Step 4: Configure the Hostname

Enter a hostname for your Proxmox node. Use a descriptive name like proxmox-01 or dc-node-1. This name appears in the web interface and SSH sessions.

Confirm the hostname entry. The system will update the /etc/hostname file automatically. This helps identify the server in a cluster environment later.

Step 5: Install the System

Review the summary screen to ensure all settings are correct. Click Install to begin the installation process. The installer will copy files to the disk and configure the bootloader.

Wait for the progress bar to reach 100%. The installation typically takes 10 to 15 minutes on modern hardware. A reboot prompt will appear once the process finishes.

Step 6: Reboot into the Proxmox System

Click Reboot now to restart the server. Remove the installation USB drive before the system boots to avoid boot loops. Watch the boot sequence to ensure the system loads the Proxmox kernel and displays the login prompt.

Log in using the root username and the password you set in Step 3. You will see the Proxmox login prompt. If you configured a static IP, open a browser on another machine and navigate to the IP address.

Verify the installation

Open a web browser and navigate to https://<server-ip>:8006. Accept the security warning about the self-signed certificate. You will see the Proxmox login screen. Enter root and your password to access the dashboard. The dashboard displays your node status, available resources, and the option to add nodes to a cluster.

Alternatively, run this command in the terminal to check the Proxmox version:

proxmox-version

You will see output like 8.2.0 confirming the correct version is installed.

Troubleshooting

Error: "Network interface not found"
The installer could not detect your network card. Check the BIOS to ensure the NIC is enabled. Verify the cable is connected and the switch port is active. Try selecting the interface again after a reboot.

Error: "Failed to set hostname"
This often happens if the system hostname conflicts with an existing DNS record. Edit /etc/hosts manually to map the hostname to the IP address. Run hostnamectl set-hostname proxmox-01 to apply changes.

Error: "Cannot access web interface"
Ensure port 8006 is open on the firewall. Run iptables -L to check rules. If using UFW, run ufw allow 8006 to permit traffic. Reboot the system if the service is not starting.

Error: "ZFS not detected"
If you intend to use ZFS, you must install the ZFS kernel module during the initial setup. The installer will prompt you to install ZFS. Select Yes to enable ZFS support. Without this, you cannot create ZFS pools.

Error: "SSH connection refused"
Ensure the SSH service is running. Check status with systemctl status ssh. Start the service if stopped with systemctl start ssh. Verify the root password is correct and the SSH key is not locked.

Error: "Disk not recognized"
Check the disk in the BIOS or using lsblk. Ensure the drive is formatted correctly. If using RAID, configure the array before the Proxmox installer finishes. The installer will not format drives intended for ZFS pools automatically.