Sovereignty, Privacy & Economic Freedom.

Guides

Setting Up Proxmox: A Step-By-Step Guide

proxmox logo

test

Proxmox Virtual Environment (VE) is an open-source server virtualization management solution that allows you to create and manage multiple virtual machines on a single physical server. It is a fantastic tool for both business and home lab use.

This guide will take you through the installation, configuration, and setup of Proxmox VE.

Prerequisites:

  1. A dedicated server or a computer with at least one modern CPU (Intel or AMD), 8 GB RAM, and 20 GB hard disk space.
  2. A valid internet connection to download the Proxmox VE ISO and for updates.
  3. Basic knowledge of Linux command-line operations and networking.
  4. ISO image of the Proxmox VE, downloaded from the official Proxmox website.
  5. An adequately sized USB flash drive.

Step 1: Prepare for Installation

After downloading the Proxmox ISO image, the first step is to create a bootable USB. I recommend downloading Balena Etcher for this as it’s open-source and available in a wide range of formats, including AppImage, dmg, exe, deb & rpm.

Once your bootable media is ready, insert it into your server or computer and boot from it. Depending on your system, you might need to adjust the boot order in the BIOS or use the boot menu option. This is most commonly F12 or F2 but varies from system to system.

Step 2: Install Proxmox

After successfully booting from the Proxmox VE installation media, you will be presented with the Proxmox VE installer:

  1. Welcome Screen: Click on “I agree” to the terms and conditions.
  2. Installation Target: Select the hard disk where Proxmox VE should be installed.
  3. Country and Timezone: Select your country, timezone, and keyboard layout.
  4. Management Password: Provide an email address and set a strong password. These credentials will be used to log in to the Proxmox web interface.
  5. Network Configuration: Enter your desired hostname and your server’s IP address. The installer also asks for a gateway and DNS server. This is often automatically prefilled. For your hostname, I recommend using “pve1.local”, numbering according to each new node you add.
  6. Once you’ve filled in all the necessary information, click “Install” to start the installation process.

The installation process typically takes 10 minutes, depending on your server’s hardware capabilities. After the installation is completed, remove your installation media and restart the system.

Step 3: Access Proxmox Web Interface

The Proxmox VE interface allows you to manage virtual machines, containers, clusters, storage, networks, and system tools.

Navigate to “https://your-server-ip:8006“. Replace “your-server-ip” with the actual IP address of your server. Log in as “root” using the password you created during the installation.

Before you start creating VMs, it’s necessary to perform some initial configurations:

  1. Subscription Message: When you first log in, you’ll see a subscription nag. Proxmox VE is free to use, but the company offers subscription plans for enterprise users that provide access to stable updates and technical support. You can dismiss the warning message if you don’t plan on purchasing a subscription.
  2. Network Configuration: Navigate to “System” > “Network” to review or change your network settings.
  3. Update Your System: Navigate to “System” > “Updates” and install any available updates to ensure you’re running the latest version.
  4. Configure Storage: Under “Datacenter” > “Storage”, you can add and manage storage for your VMs and containers.

Step 4: Post-Install Configuration

The following script allows you to efficiently configure your Proxmox VE repositories, including:

  1. Disabling the Enterprise Repo if you’re not using a paid license.
  2. Adding or correcting PVE sources.
  3. Enabling the No-Subscription Repo.
  4. Adding the test Repo.
  5. Disabling the subscription nag on login.

On the left-hand side, you will find your server list. Select “pve1”, then select “Shell” from the sub-menu. Log in as “root” and run the script.

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/misc/post-pve-install.sh)"

Answering “yes” (y) to all options presented during the process is recommended.

Step 6: Creating a Non-root User

Using a non-root user for management tasks is always good practice in any production environment. This reduces the risk of accidental changes that can affect the entire system. Here’s how you can create a non-root user:

  1. Create User: Navigate to “Datacenter” > “Users”. Click on “Add” to open the Create user dialogue. Enter a username, password, and email for the user.
  2. Assign Permissions: Navigate to “Datacenter” > “Permissions”. Click on “Add” to open the add permissions dialogue. Here you can set permissions for the new user. Choose the user you just created, select the role (PVEVMAdmin, for example, allows full access to VMs and containers), and select the path (“/” for all).

Now, you can log out and log back in again as the new user. If required, you can always change the permissions later.

Step 7: Creating LXC Containers

Linux Containers (LXC) provide lightweight virtualization that lets you run multiple isolated Linux systems (containers) on a single host. Proxmox VE has integrated LXC support, making creating and managing LXC containers easy.

Here’s how you can create an LXC container:

  1. Download an LXC Template: Before creating an LXC container, you need to download an LXC template. Navigate to “pve1” > “local (pve1)” > “CT Templates” > “Templates”. A list of available templates will be displayed. Select your preferred template and click “Download”.
  2. Create an LXC Container: Navigate to the Proxmox web interface’s main page and click on “Create CT” (CT stands for Container).
  3. General Settings: Enter the container’s ID, hostname, and password. You can leave the resource pool as “No Pool” and the storage as local-lvm. It’s recommended to leave “unprivileged” and “nesting” checked.
  4. Template: Select the template you downloaded earlier.
  5. Root Disk: Specify the size of the root disk. The default is usually enough for most uses.
  6. CPU and Memory: Specify the number of cores and the memory size.
  7. Network: Configure the network settings. You can leave it as DHCP if your network has a DHCP server.
  8. Confirm Settings: Review all the settings and click “Finish” to create the container.

Your container will be created and listed in the Proxmox web interface. You can start, stop, and manage the container directly from the interface.

Remember that LXC containers share the same kernel as the host, so they should all be Linux-based. If you need to run a non-Linux operating system, you will need to create a full virtual machine (KVM) instead.

Proxmox Virtual Environment is a complete open-source platform for enterprise virtualization. With the built-in web interface you can easily manage VMs and containers, software-defined storage and networking, high-availability clustering, and multiple out-of-the-box tools using a single solution.

Proxmox.com

Step 8: Creating Virtual Machines

8a. Download an ISO Image

Before creating a VM, you must have an ISO image of the operating system you want to install on the VM. You can usually download these from the website of the operating system vendor.

Once you’ve obtained the ISO image, you need to upload it to Proxmox. Navigate to “pve1” > “local (pve1)” > “ISO Images” and click “Upload”. Browse to the ISO image file on your computer and upload it.

8b. Open the New Virtual Machine Wizard

From the Proxmox web interface, click on “Create VM” in the upper right-hand corner. This will open the New VM wizard.

8c. Configure the VM

The VM wizard will guide you through the process of setting up your VM.

  • General: Here, you will need to provide a name for your VM. An ID will be automatically generated, but you can change this if you like.
  • OS: Click on “ISO image” and select the ISO you uploaded earlier. If you’re installing a Linux distribution or Windows, you can leave the guest OS on “Other”.
  • System: Choose your BIOS type. If you’re unsure, leaving it on the default value is safe.
  • Hard Disk: Choose your Bus/Device. If you’re not sure, “VirtIO SCSI Single” is generally a good choice. For storage, choose the location where you want your VM’s disk image to be stored & enter the hard disk size you want for the VM.
  • CPU: Enter the number of sockets and cores you want to allocate to your VM.
  • Memory: Define how much memory to allocate to your VM.
  • Network: leave set to defaults unless you have a reason not to.

After you have configured these settings, click “Next” to review your configuration. If everything looks good, click “Finish”.

8d. Install the Operating System

After the VM is created, it will appear in the server view. Click on the VM, and then click “Start” at the top of the screen.

To open the console, click on “Console” from the sub-menu. The console allows you to interact with your VM as if you were sitting in front of its monitor.

At this point, you should see the installer for the operating system that you’ve chosen. You can install the OS just as you would on a physical machine.

Rounding Up

Setting up a virtualization environment requires practice. Don’t hesitate to experiment with different settings and configurations. As long as you’re not risking any critical data, feel free to explore and learn.

Following this guide, you should now have a functional Proxmox VE setup and have created your first container and virtual machine. If you encounter issues or need advanced configurations, the Proxmox community and the Proxmox VE documentation sites are excellent resources for further learning and troubleshooting.

Enjoy!