GoAdmio

proxmox

Install Proxmox VE on a Debian 12 server, with a DHCP server on the vmbr0 bridge and rclone

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/proxmox turns a Debian 12 ("bookworm") server into a Proxmox VE virtualization host. It:

The installation steps run once: after the repository file exists, running the command again only repeats the hostname check and the interface backup (see Troubleshooting).

[!WARNING] Installing Proxmox changes how the server uses its network. A wrong network configuration can cut off SSH after a reboot. Make sure you have console or KVM access before you start, and check the configuration made by interfaces before you reboot.

The command runs sudo internally, so run it as root or as a user with sudo rights. The server needs internet access. The command does not check the operating system, so run it only on Debian 12.


Quick start

# Install Proxmox VE
/go/proxmox

Then reboot the server so it starts with the Proxmox kernel.


Syntax

/go/proxmox

The command takes no arguments. Anything you add is written to the command log but otherwise ignored.

Every run is recorded in /var/log/go/proxmox.log, with the time and the arguments you passed.


Options

None.


Output

The command prints no summary. You see the output of the package manager as it works. The installation takes a while, so run it inside screen so a lost connection doesn't interrupt it.

Outcome What you get
Hostname has fewer than 2 dots Invalid Server Hostname, A hostname should consist of a name and a domain name. All valid hostnames should have 2 dots in them. Exit status 1. Nothing is changed.
First run Package manager output for each step.
Repository file already exists Nothing is installed. Only the hostname check and the interface backup run.

The command does not stop when a step fails, and its exit status is that of the last command it ran. Read the output for errors.

Log

Each run appends one line to /var/log/go/proxmox.log:

[Nov 21 12:00:00]# proxmox

Examples

# Install inside screen so a dropped SSH connection doesn't stop it
screen -S proxmox /go/proxmox
# Check the hostname before you start (it needs a name and a domain)
cat /etc/hostname
# After the reboot, check the installed version
pveversion

After the reboot, open the web interface at https://<server-ip>:8006 and log in as root with the server's root password.


Troubleshooting

Symptom Likely cause Fix
Invalid Server Hostname ... The hostname has fewer than 2 dots (for example pve or example.com). Set a full hostname such as pve.example.com, then run the command again.
Running the command again does nothing /etc/apt/sources.list.d/pve-install-repo.list already exists. It is created partway through, so a run that failed after that point is not retried. Delete that file, fix the cause of the failure, then run the command again.
Unable to locate package proxmox-ve or repository errors The server isn't running Debian 12. The repository is for "bookworm". Use a Debian 12 server.
The proxmox-ve install fails about the hostname The hostname doesn't resolve to the server's own IP address (not a 127.x address) in /etc/hosts. Add a line with the server's IP and hostname to /etc/hosts, then run apt -y install proxmox-ve again.
The DHCP server isn't running /etc/dhcp/dhcpd.conf has no subnet for vmbr0, or vmbr0 doesn't exist yet. Configure vmbr0 (see interfaces) and the DHCP subnet, then restart isc-dhcp-server.
SSH is lost after a reboot The network configuration is wrong. Use the console and restore /etc/network/interfaces.bak, or correct the file.
The web interface doesn't open The server hasn't been rebooted, or port 8006 is blocked. Reboot, and open the port with allow.

Details

What it does

Step Detail
1. Hostname check The hostname in /etc/hostname must contain at least 2 dots.
2. Interface backup Copies /etc/network/interfaces to /etc/network/interfaces.bak, only if that backup doesn't exist yet.
3. Repository check If /etc/apt/sources.list.d/pve-install-repo.list exists, the command stops here.
4. Hostname Applies the hostname from /etc/hostname with hostnamectl.
5. Tools Installs curl and screen.
6. Repository Downloads the Proxmox "bookworm" release key and adds the pve-no-subscription repository.
7. Packages Runs apt update and apt full-upgrade, then installs net-tools and proxmox-ve.
8. DHCP server Disables dhcpcd, installs isc-dhcp-server, writes /etc/default/isc-dhcp-server so it serves IPv4 on vmbr0 only, then enables and restarts the service.
9. rclone Creates /root/.config/rclone and installs rclone with its install script.

The pve-no-subscription repository doesn't need a Proxmox subscription. Proxmox recommends it for testing rather than production.

What you still do yourself

The command leaves these steps to you:

Step Why
Create the vmbr0 bridge and check the network settings The DHCP server is set to use vmbr0, but the command doesn't create it. See interfaces.
Configure /etc/dhcp/dhcpd.conf The DHCP server needs a subnet for vmbr0 before it can hand out addresses.
Reboot The server must start with the Proxmox kernel.
Set up rclone remotes Put the remote storage settings in /root/.config/rclone/rclone.conf.
Choose where VM data is stored To use a separate disk, format it and mount it at /var/lib/vz.

If Proxmox can't be installed, the script's own comments suggest checking the Debian package sources in /etc/apt/sources.list. They also note that on some systems the systemd-networkd services need to be enabled for the network to come up.

flowchart TD
    A["proxmox"] --> B["Log the run"]
    B --> C{"Hostname has 2 or more dots?"}
    C -- "No" --> X["Error, exit 1"]
    C -- "Yes" --> D["Back up /etc/network/interfaces once"]
    D --> E{"pve-install-repo.list exists?"}
    E -- "Yes" --> Z["Done, nothing installed"]
    E -- "No" --> F["Add the Proxmox key and repository"]
    F --> G["apt full-upgrade, install proxmox-ve"]
    G --> H["Install the DHCP server for vmbr0"]
    H --> I["Install rclone"]
    I --> J["You: configure vmbr0 and DHCP, then reboot"]

See also

Command Description
interfaces Create an interfaces file for Proxmox
hostname Change the server hostname and set up GoAdmio, mail, and SSL for it
allow Open a TCP port in the server firewall
firewall Install and configure the server firewall (firewalld or UFW) with GoAdmio's default open ports, and start, stop, or reset it