Proxmox Virtual Environment (Proxmox VE) lets you efficiently manage virtual machines and containers on Linux. This guide walks you through installing Proxmox VE on Debian 12 (Bookworm) and getting it up and running.

Step 1: Prepare the server

Before you begin, make sure your server has sufficient resources. For a typical test or production setup, a quad-core processor, 8 GB of RAM and 100 GB of disk space are recommended as a minimum.

Ensure that Debian 12 has also been installed correctly and has an active internet connection. Then update all packages to bring the system up to date before you install Proxmox.

sudo apt update && sudo apt upgrade -y
sudo reboot
bash
Tip

Unlike a dedicated (bare-metal) Proxmox installation, installing Proxmox on top of Debian 12 gives you full control over the operating system. You can install extra packages and services as needed while also benefiting from Debian’s proven stability.

Step 2: Add the Proxmox repository

Proxmox isn’t included in Debian’s official package sources, so you’ll need to add its repository manually. Start by importing the Proxmox GPG key:

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

Next, add the Proxmox VE repository:

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

Then update your package list:

sudo apt update
bash
Note

This guide intentionally uses the ‘no-subscription’ repository from Proxmox, which is freely available and ideal for testing environments, home labs or smaller production systems. It includes all essential updates and security patches but doesn’t provide enterprise-grade support or access to the Enterprise repository. If you’re using Proxmox in a business setting, consider purchasing a subscription to receive regular verified updates and official support.

Step 3: Install the Proxmox kernel

Before setting up the Proxmox Virtual Environment, first install the Proxmox kernel, which is optimised for virtualisation and provides better performance and compatibility. You can do this using the following terminal commands:

sudo apt install proxmox-default-kernel -y
sudo reboot
bash

Step 4: Install Proxmox

Now install Proxmox VE and its core components. The command below installs all required packages automatically:

sudo apt install proxmox-ve postfix open-iscsi -y
bash

During installation, you’ll be asked to configure Postfix. Select Internet Site and enter your server’s hostname. When the installation finishes, restart the system:

sudo reboot
bash

Step 5: Remove unnecessary Debian kernels

After installation, your system uses the new Proxmox kernel, which is based on Debian but optimised for virtualisation. To avoid boot menu clutter and potential conflicts, remove the default Debian kernel (usually linux-image-amd64). This keeps your system clean and helps prevent possible issues during future updates.

Run the following commands:

sudo apt remove linux-image-amd64 linux-image-6.1* -y
sudo update-grub
bash

The first command removes unused Debian kernel packages. The second updates the bootloader, so the system boots with the Proxmox kernel by default. Then restart to load the new kernel:

sudo reboot
bash

After the reboot, check that the Proxmox kernel is active:

uname -r
bash

The output should now look something like this: 6.8.4-3-pve. If you see this kind of version label, it confirms the system is running the Proxmox kernel.

Step 6: Access the Proxmox web interface

Proxmox is now fully installed and ready for use. You can manage it entirely through its web interface, which you can access via any browser. To do so, open the browser of your choice and enter your server’s IP address, followed by the default port 8006 in the address bar. Use the HTTPS protocol, which encrypts the connection by default and keeps data secure:

https://<YOUR-IP-ADDRESS>:8006/

Your browser may show a warning that the SSL certificate isn’t trusted. This is normal because Proxmox uses a self-signed certificate. Accept the warning to proceed. You’ll then see the Proxmox VE login page. Sign in as the user ‘root’ using your Debian password. Keep the Realm field set to Linux PAM standard authentication.

Note

If you have trouble accessing the Proxmox web interface through port 8006, a firewall might be blocking the connection. Make sure this port is open in your firewall settings so that you can connect to the web interface.

After logging in, the Proxmox dashboard will appear. From here, you can:

  • Create and manage virtual machines and containers
  • Configure storage and networks
  • Monitor system resources such as CPU, RAM and disk-space usage

Your installation is now complete, and you can start creating your first virtual environment.

Step 7: Adjust repositories and remove warning messages

After successfully installing Proxmox and logging in for the first time, you’ll see a message stating that no active subscription is available. This warning appears because the system is currently using the Enterprise repository, which requires a valid support licence. As we’re working with the free no-subscription repository, disable the Enterprise entry to remove the warning. To do so, use the following command:

sudo sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list
bash

This deactivates the line in the repository configuration file, so that it’s ignored during future package updates. Next, update your package sources so that the system applies the changes:

sudo apt update
bash

This adjustment doesn’t affect system stability. All it does is prevent Proxmox from displaying the licence warning at login while ensuring all future updates come from the previously configured ‘no-subscription’ repository.

Step 8: Update the system and run a final check

To complete the installation, make sure your system is fully up to date and all Proxmox services are running correctly. This will help avoid compatibility issues and ensure your environment runs smoothly. First, update all installed packages using the following command:

sudo apt full-upgrade -y
bash

After completing the update, it’s a good idea to check the status of the key Proxmox services. These processes are essential for the management interface and virtualisation features to run smoothly:

sudo systemctl status pve-cluster
sudo systemctl status pvedaemon
sudo systemctl status pveproxy
bash

If all services show as active (running), your Proxmox Debian installation is working correctly. The setup is now complete and your server is ready to go live. You can use the web interface to create virtual machines and containers, configure networks and manage storage.

Once your environment is up and running, you can expand Proxmox as needed – for example, by adding a Proxmox file server for centralised storage access or a Proxmox backup server to protect your virtual machines and containers.

Go to Main Menu