Admin: New server guide

2026-04-13T10:00:34Z

New server guide

New page

= Installing Proxmox VE =

This guide provides a comprehensive, step-by-step tutorial on how to install and configure Proxmox Virtual Environment (Proxmox VE), a powerful open-source server virtualization management platform. Proxmox VE allows you to manage virtual machines (VMs) and containers (LXC), offering a flexible and efficient solution for your server infrastructure.

== Introduction ==

Proxmox VE is based on Debian Linux and integrates KVM for virtual machines and LXC for containers. It provides a web-based interface for easy management, including features like live migration, high availability, and integrated backup solutions. This tutorial assumes you have a basic understanding of Linux command-line operations.

== Prerequisites ==

Before you begin the installation, ensure you have the following:

* '''Hardware:'''
** A compatible 64-bit server.
** Minimum 2 GB RAM (4 GB or more recommended for production use).
** Sufficient disk space for the operating system and your virtual environments.
** A network interface card (NIC). For optimal performance with demanding workloads, consider dedicated GPU servers available at [https://en.immers.cloud/signup/r/20241007-8310688-334/ Immers Cloud].
* '''Installation Media:'''
** A Proxmox VE ISO image downloaded from the official Proxmox website.
** A USB drive or DVD to create bootable installation media.
* '''Network Configuration:'''
** A static IP address for the Proxmox VE server.
** The IP address of your DNS server.
** The hostname for your Proxmox VE server.
** A gateway IP address.

== Step-by-Step Installation ==

Follow these steps to install Proxmox VE from the ISO image.

=== 1. Boot from Installation Media ===

# Insert the bootable USB drive or DVD into your server.
# Reboot the server and configure your BIOS/UEFI to boot from the installation media.
# Once the server boots from the media, you will see the Proxmox VE installer menu.

=== 2. Select "Install Proxmox VE" ===

# From the GRUB boot menu, select the option to '''Install Proxmox VE''' and press Enter.

=== 3. Accept the End-User License Agreement (EULA) ===

# Read the EULA carefully.
# Click '''I Agree''' to proceed.

=== 4. Select Target Disk ===

# Choose the disk where you want to install Proxmox VE.
# '''Important:''' All data on the selected disk will be erased.
# Click '''Next'''.

=== 5. Configure Disk Options ===

# For most users, the default options are suitable.
# '''Filesystem:''' ZFS is recommended for its advanced features like snapshots and data integrity, but requires more RAM. ext4 is a simpler, widely compatible option.
# '''ZFS Options:''' If you choose ZFS, you can select the RAID level (e.g., mirror for redundancy).
# Click '''Next'''.

=== 6. Configure Location and Timezone ===

# Select your '''Country''', '''Timezone''', and '''Keyboard Layout'''.
# Click '''Next'''.

=== 7. Network Configuration ===

# This is a critical step. Ensure you have a static IP address planned.
# '''Hostname:''' Enter a fully qualified domain name (FQDN) for your server (e.g., `pve.yourdomain.local`).
# '''IP Address:''' Enter the static IP address for your Proxmox VE server (e.g., `192.168.1.100`).
# '''Subnet Mask:''' Enter your network's subnet mask (e.g., `255.255.255.0`).
# '''Gateway:''' Enter your network's gateway IP address (e.g., `192.168.1.1`).
# '''DNS Server:''' Enter the IP address of your DNS server (e.g., `192.168.1.1`).
# Click '''Next'''.

=== 8. Set Root Password ===

# Enter a strong password for the root user. This password will be used to log in to the Proxmox VE web interface.
# Confirm the password.
# Click '''Next'''.

=== 9. Review and Install ===

# Review all the configuration settings.
# If everything is correct, click '''Install'''.
# The installation process will begin. This may take some time.

=== 10. Reboot ===

# Once the installation is complete, you will be prompted to reboot the server.
# Remove the installation media and click '''Reboot'''.

== Post-Installation Configuration ==

After the server reboots, you can access the Proxmox VE web interface.

=== 1. Accessing the Web Interface ===

# Open a web browser and navigate to the IP address of your Proxmox VE server, prefixed with `https://` and followed by port `8006`.
# For example: '''https://192.168.1.100:8006'''
# You will see a security warning because of the self-signed certificate. Proceed by clicking "Advanced" and then "Accept the Risk and Continue".

=== 2. Logging In ===

# '''Username:''' `root`
# '''Password:''' The password you set during installation.
# Click '''Login'''.

=== 3. Updating Proxmox VE ===

It's highly recommended to update your Proxmox VE installation to the latest stable version.

# In the web interface, navigate to '''Node''' -> '''Updates'''.
# Click '''Refresh list'''.
# If updates are available, click '''Upgrade all'''.
# You can also perform updates via the command line:
<pre>
# apt update
# apt dist-upgrade -y
</pre>

=== 4. Configuring Repositories ===

By default, Proxmox VE uses the enterprise repository, which requires a subscription. For non-production environments, you can switch to the no-subscription repository.

# '''Via Web Interface:'''
# Navigate to '''Node''' -> '''Repositories'''.
# You will likely see the enterprise repository listed. You can disable it or remove it.
# Click '''Add''' -> '''No-Subscription'''.
# Fill in the details:
# * '''URL:''' `http://download.proxmox.com/debian/pve`
# * '''Distribution:''' `pve-no-subscription`
# * '''Components:''' `main`
# Click '''OK'''.
# You will need to refresh the updates list again after changing repositories.

# '''Via Command Line:'''
# Edit the sources.list file:
<pre>
# nano /etc/apt/sources.list
</pre>
# Comment out or remove the enterprise repository line.
# Add the no-subscription repository:
<pre>
deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
</pre>
# Save the file and then run:
<pre>
# apt update
</pre>

=== 5. Basic Network Configuration (Optional) ===

You can further refine your network settings through the web interface.

# Navigate to '''Node''' -> '''Network'''.
# Here you can configure additional network devices, bridges, etc.

== Troubleshooting ==

* '''Cannot access web interface:'''
** Ensure the Proxmox VE server is powered on and has a valid IP address.
** Check your firewall rules to ensure port 8006 is open.
** Verify the network configuration during installation was correct.
** Try pinging the Proxmox VE server from another machine on the same network.

* '''Installation fails:'''
** Double-check hardware compatibility.
** Ensure the ISO image is not corrupted.
** Try a different USB drive or DVD.

* '''Updates fail after changing repositories:'''
** Make sure you have commented out the enterprise repository correctly.
** Verify the URL and distribution for the no-subscription repository are accurate.
** Run `apt update` again after any changes.

== Further Reading ==

* [[Proxmox VE: Storage Configuration]]
* [[Proxmox VE: Creating Virtual Machines]]
* [[Proxmox VE: Managing Containers]]

[[Category:OS Installation]]
[[Category:Virtualization]]
[[Category:Proxmox VE]]

Installing Proxmox VE - Revision history

Admin: New server guide