proxmox
Install Proxmox VE on a Debian 12 server, with a DHCP server on the
vmbr0bridge and rclone
- Command:
/go/proxmox - Category: Installation
- Required option: None
- Output: Package manager output; also logged to
/var/log/go/proxmox.log - Last updated: 2026-11-21
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:
- checks that the server hostname is a full name with a domain
- backs up
/etc/network/interfacesto/etc/network/interfaces.bak - adds the Proxmox VE "no-subscription" package repository and its signing key
- upgrades the system and installs
proxmox-ve - installs an ISC DHCP server and points it at the
vmbr0bridge, so virtual machines can get addresses - installs
rcloneand creates its configuration folder
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
interfacesbefore 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 |