↓ Skip to main content
mi-homes.org

Proxmox Installation

Table of Contents

This guide documents how to install a new Proxmox VE node, perform the first login, join it to an existing cluster, and configure the no-subscription repositories.

Create the installation USB
#

Install Proxmox VE
#

  • Boot the target machine from the Proxmox USB stick.
  • Keep the machine connected to ethernet during installation so the installer can detect the correct network.
  • In the installer:
    • Enter your email address when prompted.
    • Set the hostname to e.g. pve-ms-01.local.
    • Confirm that the IP address matches the one identified in your network for this node; normally it is auto-detected correctly.
  • For laptops, avoid closing the lid during installation to prevent sleep or suspend.
  • Complete the installer and reboot into Proxmox VE.

First login to the web interface
#

  • From another machine on the same network, open:

    https://<proxmox-ip>:8006

  • At the login screen:

    • User: root
    • Realm: Linux PAM standard authentication
    • Password: The one set in the previous step

After logging in, acknowledge an initial warning (e.g. about subscription or no valid cluster) and proceed.

Join the node to an existing cluster
#

On the new node, open a shell (either via the web UI or SSH) and run:

pvecm add CLUSTER_IP

Replace CLUSTER_IP with the IP address of any existing Proxmox node in the cluster. Follow the prompts to join; afterwards you can verify with:

pvecm status

Allow Synology NFS access
#

Add this node’s IP address to the Synology NFS permissions so it can access the synology-nfs storage:

  • On the Synology:
    • Go to Control Panel > Shared Folder.
    • Select the folder dedicated to store Proxmox VMs, e.g. proxmox-vm and click Edit.
    • Adjust the NFS permissions to include the new node’s IP address.

Add the node to the HA group
#

  • In the Proxmox web UI, go to Datacenter > HA > Groups.
  • Edit the existing HA group and add the new node.
  • Save the changes so the node can participate in high availability.

Change the root password
#

After the node is joined and accessible:

  • Open a shell on the node (via the Proxmox web UI or SSH).

  • Run:

    passwd

  • Enter and confirm the new root password.

  • Save it in your password manager.

Proxmox VE no-subscription repository setup
#

By default, Proxmox VE enables enterprise repositories that require a subscription. Without a subscription, running:

apt-get update

will return 401 Unauthorized errors. To fix this, configure the no-subscription repositories by editing two files. Replace trixie with your Debian codename (check with:

lsb_release -cs

).

/etc/apt/sources.list.d/pve-enterprise.sources
#

# /etc/apt/sources.list.d/pve-enterprise.sources
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

/etc/apt/sources.list.d/ceph.sources
#

# /etc/apt/sources.list.d/ceph.sources
Types: deb
URIs: http://download.proxmox.com/debian/ceph-squid
Suites: trixie
Components: no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

After saving both files, run:

apt-get update
apt-get dist-upgrade

to refresh package lists and apply the latest updates from the no-subscription repositories.