Install Proxmox VE on top of an existing Debian server

Many rented dedicated servers only offer stock Linux images and no way to boot your own ISO. In that case you can install Proxmox VE on Debian: install the matching Debian release first, then add Proxmox packages on top.

Before you start

• A fresh, minimal 64-bit Debian install of the release that matches the Proxmox version you want (for example Debian 12 "bookworm" for Proxmox VE 8). Check the official Proxmox wiki for the current pairing.
• Root access and an out-of-band console (KVM over IP or rescue system) in case networking breaks.
• Hardware virtualisation enabled (enable VT-x/AMD-V).

If you can boot the ISO, the standard installer is easier (install Proxmox VE).

Set the hostname and hosts file

The hostname must resolve to the server's public IP, not to 127.0.1.1. Example /etc/hosts line:

203.0.113.10 pve1.example.com pve1

Check it with hostname --ip-address; it must print the server IP.

Add the Proxmox repository

Download the repository key and add the no-subscription repository (bookworm shown):

wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg

echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-install-repo.list

apt update && apt full-upgrade -y

Install the Proxmox kernel and packages

1. Install the Proxmox kernel and reboot into it:

apt install proxmox-default-kernel -y

2. After the reboot, install Proxmox VE:

apt install proxmox-ve postfix open-iscsi chrony -y

3. Remove the stock Debian kernel and os-prober as the Proxmox wiki recommends, then run update-grub.

Create the network bridge

Open https://SERVER_IP:8006, log in as root (realm Linux PAM), and create vmbr0 under Node → System → Network, moving the server IP from the NIC to the bridge. Do this with console access ready. If your provider filters MAC addresses, use a routed setup (bridges and routed setups).

Check afterwards

• pveversion shows Proxmox VE and uname -r shows a Proxmox kernel.
• The web UI loads and you can create a test VM.

Troubleshooting

• pve-cluster fails to start: the hostname does not resolve to the public IP in /etc/hosts.
• Server unreachable after network change: fix /etc/network/interfaces from the provider console.
• Repository errors: mismatched Debian and Proxmox codenames.

Frequently asked questions

Is a Debian-based install as good as the ISO?

Yes, the result is the same Proxmox VE; only the installation path differs.

Can I use software RAID?

Yes, set up mdadm or ZFS when installing Debian or afterwards for data disks.

Should I set up the firewall right away?

Yes, restrict port 8006 and SSH first (firewall setup).

Next steps

• Repositories and updates
• Security hardening
• Create a VM