Proxmox 9¶

In dit artikel

• Implementatiefuncties
• Proxmox 9. Installatie
• Eerste Login en Basiscontrole
• Netwerk: Bridge vmbr0
• Schijven en Opslag
• ISO-images laden
• De eerste VM maken (Ubuntu 25.10)
• Windows Installatie (voor krachtigere nodes)
• LXC Containers: Snelstart
• Typische VM-profielen
• VM's en LXC verbinden in één netwerk
• Back-ups en Templates
• Veelvoorkomende Problemen en Oplossingen
• Diagnostiek: Cheat Sheet
• Mini-FAQ
• Readiness Checklist voor het Systeem
• Een server bestellen met Proxmox 9 via API

Implementatiefuncties¶

Proxmox 9. Installatie¶

Na het installeren van de server wordt de installatie van de Proxmox VE-service uitgevoerd binnen 15-20 minuten. Er wordt een e-mail verzonden naar het e-mailadres dat aan het account is gekoppeld, waarin u wordt geïnformeerd over de geïnstalleerde server en een link wordt verstrekt in het formaat https://proxmox<ID_server>.hostkey.in, die u moet openen om de webbeheerinterface voor Proxmox VE te openen:

• Login - root;
• Password - systeemwachtwoord.

Eerste Login en Basiscontrole¶

1. Open uw browser > https://proxmox{Server_ID}.hostkey.in en voer de inloggegevens in:

   

2. Navigeer naar: Datacenter > Node > Summary - controleer CPU, RAM, schijven en uptime.

   

3. Schakel het enterprise repository uit als er geen abonnement is:

Node > Repositories > pve-enterprise > Disable. Houd pve-no-subscription aan:

Terminal Commando's:

sed -i 's/^deb/#deb/g' /etc/apt/sources.list.d/pve-enterprise.list || true

apt update

Netwerk: Bridge vmbr0¶

De bridge vmbr0 is een virtuele "switch" waaraan VM's zijn verbonden. Deze is gekoppeld aan een fysieke interface (bijv. ens18/eno1).

Via de Webinterface¶

1. Node > System > Network.

   

2. Controleer of vmbr0 bestaat. Als deze niet bestaat of niet is geconfigureerd - Create > Linux Bridge:

   • Name: vmbr0
   • IPv4/CIDR: specificeer uw statische IP in het formaat X.X.X.X/YY (laat leeg als u DHCP gebruikt);
   • Gateway (IPv4): standaard gateway (meestal X.X.X.1) (niet invoeren als u DHCP gebruikt);
   • Bridge ports: uw fysieke interface, bijvoorbeeld ens1;
   • Save > Apply configuration:

   

Via CLI (als webtoegang verloren is gegaan)¶

Voorbeeld /etc/network/interfaces (ifupdown2):

auto lo
iface lo inet loopback
auto ens18
iface ens18 inet manual
auto vmbr0
iface vmbr0 inet static
    address 192.0.2.10/24
    gateway 192.0.2.1
    bridge-ports ens18
    bridge-stp off
    bridge-fd 0

ifreload -a

Veelvoorkomende fouten:

• Verkeerd gespecificeerde bridge-ports (verkeerde fysieke interface) > netwerk "verdwijnt". Corrigeer de interface en voer ifreload -a uit.
• Verkeerde gateway of subnet ingevoerd > lokale verbinding is aanwezig maar er is geen internettoegang.

Schijven en Opslag¶

Voeg een tweede schijf toe voor VM-opslag¶

1. Node > Disks: zorg ervoor dat de nieuwe schijf zichtbaar is (bijv. sdb).

   

2. Optie A - LVM-Thin (handig voor snapshots):

   • Disks > LVM-Thin > Create: selecteer de schijf > specificeer VG-naam (bijv. pve2) en thin-pool (bijv. data2).

   

   • De opslag verschijnt in Datacenter > Storage.

   

3. Optie B - Directory:

   • Maak een bestandssysteem aan (Disks > ZFS of handmatig mkfs.ext4), mount naar /mnt/...

   

   • Datacenter > Storage > Add > Directory > pad /mnt/... > schijf-image en ISO-image inschakelen (indien nodig).

ISO-images laden¶

ISO-images kunnen op twee manieren worden geladen.

A. Via de Webinterface¶

1. Datacenter > Storage > (selecteer storage met type ISO, bijv. local) > Content.
2. Upload > selecteer lokale ubuntu-25.10-live-server-amd64.iso > wacht tot de upload voltooid is.

B. Via de Node (CLI)¶

Voorbeeld van het downloaden van de Ubuntu 25.10 ISO naar local opslag:

cd /var/lib/vz/template/iso

wget https://releases.ubuntu.com/25.10/ubuntu-25.10-live-server-amd64.iso

De eerste VM maken (Ubuntu 25.10)¶

Voorbeeld: Ubuntu Server 25.10 (VPS met 2 vCPU)

Klik op Create VM (rechtsboven):

General: Laat ID op de standaardwaarde staan, Name - ubuntu2510 (of uw eigen naam):

OS: selecteer ISO ubuntu-25.10-live-server-amd64.iso, Type: Linux:

System:

• Graphics card: Default;
• BIOS: OVMF (UEFI);
• Machine: q35;
• SCSI Controller: VirtIO SCSI single;
• (Optioneel) Schakel Qemu Agent in bij Options na het maken van de VM (zie hieronder):

Disks:

• Bus/Device: SCSI;
• SCSI Controller: VirtIO SCSI single;
• Storage: uw LVM-Thin/Directory;
• Size: 20–40 GB (minimaal 10-15 GB voor testen);
• Discard (TRIM): inschakelen op een thin-pool:

CPU:

• Sockets: 1;
• Cores: 2 (conform uw VPS);
• Type: host (beste prestaties):

Memory:

• 2048–4096 MB. U kunt Ballooning inschakelen (bijv. Min 1024, Max 4096):

Network:

• Model: VirtIO (paravirtualized);
• Bridge: vmbr0;
• Indien VLAN nodig is: VLAN Tag:

Confirm: controleer de instellingen, vink Start after created aan en klik op Finish:

OS Installatie:¶

1. Start de VM > Console (noVNC) > Try or Install Ubuntu:

   

2. Installer:

   • DHCP/statische IP indien nodig;
   • Disk: Use entire disk;
   • Profile: gebruiker/wachtwoord;
   • OpenSSH server: inschakelen.

3. Reboot en log in via console/SSH.

Na de installatie:¶

sudo apt update && sudo apt -y full-upgrade

sudo apt -y install qemu-guest-agent

sudo systemctl enable --now qemu-guest-agent

Boot Order: indien opstarten vanaf ISO - Options > Boot Order > verplaats scsi0 boven cdrom.

Windows Installatie (voor krachtigere nodes)¶

Geschikt voor nodes met ≥4 vCPU/8 GB RAM. Op zwakkere VPS kan Windows onstabiel werken.

1. ISO: Download de ISO's van Windows Server (2019/2022/2025) en virtio-win.iso (drivers) in Storage > Content:

   

2. Create VM > OS: Microsoft Windows, selecteer de installatie ISO-image. De optie Add additional drive for VirtIO drivers stelt u in staat een tweede CD met drivers toe te voegen:

   

3. System: BIOS OVMF (UEFI);

   • Machine: q35;
   • Indien nodig, schakel Add EFI Disk en Add TPM in (voor nieuwe Windows-versies). Als deze niet start - probeer SeaBIOS en schakel EFI/TPM uit:

   

4. Disks:

   • Bus: SCSI;
   • Controller: VirtIO SCSI;
   • Size: 40–80 GB;
   • Schakel IO Threads in:

   

5. CPU: 2–4 vCPUs;

   • Type: host:

   

6. Memory: 4–8 GB:

   

7. Network: Model VirtIO (paravirtualized), Bridge vmbr0:

   

8. Confirm: Voltooi de VM-creatie door op Create te klikken, en voeg vervolgens in Hardware > CD/DVD Drive een tweede ISO toe - virtio-win.iso:

   

9. Windows Installer: Klik bij de stap voor schijfselectie op Load Driver > specificeer de CD met VirtIO (vioscsi/viostor). Na de installatie - stel de netwerkdrivers in via Apparaatbeheer (NetKVM):

   

10. Guest Agent (optioneel): Installeer Qemu Guest Agent voor Windows met behulp van de virtio-win ISO:

    

Probleemoplossing Windows:¶

• Zwart scherm/start niet op: Wijzig OVMF > SeaBIOS, schakel EFI/TPM uit.
• Geen netwerk: Zorg ervoor dat de NIC = VirtIO is en dat de NetKVM-driver is geïnstalleerd.
• Trage schijfprestaties: Zorg ervoor dat de schijf = SCSI + virtio driver is.

LXC Containers: Snelstart¶

Kant-en-klare templates met minimale software zijn beschikbaar in de template-opslag.

1. Datacenter > Storage > (selecteer storage met type Templates) > **Content** > **Templates**. Download bijvoorbeeld:ubuntu-25.04-standard_*.tar.zst` of een andere benodigde template:

   

2. Klik op Create CT:

   • General: Specificeer ID/Name, Unprivileged container = Enabled (standaard veiliger). Stel een root wachtwoord of SSH-sleutel in.

   

   • Template: Selecteer de gedownloade template.

   

   • Disks: Opslag/Grootte (bijvoorbeeld 8–20 GB).

   

   • CPU/RAM: Conform de taak (bijvoorbeeld 1 vCPU, 1–2 GB RAM).

   

   • Network: Bridge vmbr0, IPv4 = DHCP (of Statisch indien nodig). VLAN Tag indien nodig.

   

Tip voor Netwerk: Als u NAT gebruikt op vmbr1, stel dit dan in en specificeer het statische IP.

- **DNS**: Standaard van de host of uw eigen DNS.

- **Features**: Optioneel `nesting`, `fuse`, `keyctl` inschakelen (afhankelijk van applicaties in de container).

• Start at boot/Start after created: naar wens.
• Na het opstarten: log in via SSH en installeer software vanaf de template of via packages:

  apt update && apt -y upgrade
  

  

In LXC is de Qemu Guest Agent niet nodig. Het mounten van host-directory's gebeurt via MP (Mount points).

Typische VM-profielen¶

• Ubuntu/Debian (Web/DB/Utility): SCSI + VirtIO, UEFI (OVMF), 1–2 vCPUs, 2–4 GB RAM, schijf 20–60 GB; schakel Qemu Guest Agent in.
• Lichtgewicht Services (DNS/DHCP/Proxy): 1 vCPU, 1–2 GB RAM, schijf 8–20 GB.
• Container Hosts (Docker/Podman): 2–4 vCPUs, 4–8 GB RAM; aparte schijf/pool voor data.

Alternatief voor ISO: U kunt Ubuntu 25.10 Cloud-Init images gebruiken voor snel klonen met automatisch geconfigureerd netwerk/SSH. Geschikt als u van plan bent om veel vergelijkbare VM's te hebben.

VM's en LXC verbinden in één netwerk¶

Basisvariant (Eén Subnet):¶

1. Zorg ervoor dat alle VM's/containers Bridge = vmbr0 (of vmbr1) hebben.
2. Bij gebruik van een DHCP-netwerk worden adressen automatisch toegewezen; bij statisch - specificeer IP's in één subnet (bijvoorbeeld 10.10.0.2/24, 10.10.0.3/24) en een gemeenschappelijke gateway 10.10.0.1.
3. Optioneel. VLAN: Specificeer de VLAN Tag in de netwerkkaartinstellingen van de VM's/CT en zorg ervoor dat de uplink van de switch deze VLAN toestaat.
4. Controleer in het besturingssysteem of de lokale firewall ICMP/SSH/HTTP niet blokkeert.
5. Test: Vanaf Ubuntu VM ping <IP-LXC> en vice versa; ip route en traceroute helpen bij problemen.

Bij verschillende subnets:¶

• Proxmox zelf routeert niet tussen bridges. Een router (aparte VM met Linux/pfSense) of NAT op de host is nodig.
• Eenvoudige NAT op de host (voorbeeld):

Schakel forwarding in:

sysctl -w net.ipv4.ip_forward=1

iptables -t nat -A POSTROUTING -o vmbr0 -j MASQUERADE

EXT_IF=vmbr0

iptables -t nat -C POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE 2>/dev/null || \
iptables -t nat -A POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE

iptables -C FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT

iptables -C FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT

Back-ups en Templates¶

• Back-up: Datacenter > Backup of Node > Backup - stel een vzdump schema in (opslag, tijd, snapshot/stop-modus):

  

• VM Template: Na de basis VM-setup > Convert to Template. Het maken van nieuwe VM's via Clone bespaart tijd en voorkomt fouten:

Veelvoorkomende Problemen en Oplossingen¶

"Webinterface verdwenen" (GUI opent niet)¶

Controleer of de node bereikbaar is via SSH. Voer op de node het volgende uit:

systemctl status pveproxy pvedaemon pve-cluster

journalctl -u pveproxy --no-pager -n 100

systemctl restart pveproxy pvedaemon

Netwerk verloren na bewerking van de Bridge¶

Verbind via console (via provider/VNC/IPMI). Controleer /etc/network/interfaces en pas toe:

ifreload -a

ip a

ip r

VM maakt geen verbinding met het internet¶

• Zorg ervoor dat in de VM de juiste IP's/masker/gateway/DNS zijn ingesteld.
• Controleer of de Bridge van de netwerkadapter van de VM - vmbr0 (of nat/vmbr1) is.
• Indien VLAN wordt gebruikt - specificeer de VLAN Tag in de NIC-instellingen van de VM (Hardware > Network Device > VLAN Tag), en zorg dat de uplink van de switch deze VLAN toestaat.

ISO start niet op / Installer niet zichtbaar¶

• Controleer de Boot Order (Options > Boot Order) en of de juiste ISO is aangesloten.
• Controleer bij UEFI of Secure Boot in het gast-OS niet is ingeschakeld als de ISO dit niet ondersteunt.

Hoge belasting/Schijf "verstopping"¶

• Gebruik VirtIO SCSI en schakel IO Threads in voor intensief schijfgebruik.
• Sla back-ups niet op op dezelfde thin-pool als de actieve schijven - het is beter om een aparte opslag te hebben.

"Verbroken" Webcam/USB-apparaat in de VM¶

• Gebruik voor USB-passthrough Hardware > USB Device. Als het apparaat niet meer reageert - voer een Stop/Start uit op de VM of sluit de USB opnieuw aan op de host. Soms helpt het uitschakelen van Use USB3 bij de compatibiliteit.

Updates en Reboot¶

apt update && apt full-upgrade -y

reboot

Diagnostiek: Cheat Sheet¶

Netwerk van de node:

ip a; ip r; ping -c3 1.1.1.1; ping -c3 google.com

systemctl status pveproxy pvedaemon pvestatd pve-cluster

journalctl -u pveproxy -n 200 --no-pager

df -h | sort -k5 -h
lvs; vgs; pvs

cat /etc/pve/storage.cfg

qm list; qm config <VMID>; qm status <VMID>

qm stop <VMID> --skiplock; sleep 2; qm start <VMID>

Mini-FAQ¶

V: Kan vmbr0 worden hernoemd? A: Ja, maar het wordt niet aanbevolen op een productie-node - het is gemakkelijker om vmbr0 te laten staan en indien nodig extra bridges (vmbr1) toe te voegen.

V: Waar staan ISO's standaard? A: In de lokale opslag: /var/lib/vz/template/iso.

V: Wat is het verschil tussen local en local-lvm? A: local - een normale directory voor ISO's, container-templates, etc. local-lvm - LVM-Thin voor VM/container-schijven met snapshots.

V: Hoe clone ik snel een VM? A: Maak van een voorbeeld-VM een Template, en gebruik dan Clone > Full/Linked.

V: Hoe schaal ik de CPU/RAM van een VM veilig op? A: Schakel de VM uit en wijzig de resources; voor Linux kunnen parameters "on the fly" worden gewijzigd, maar het is beter om dit gepland te doen.

Readiness Checklist voor het Systeem¶

• Toegang tot https://<server_IP>:8006 is aanwezig;
• vmbr0 is ingesteld en er is internet vanaf de node;
• ISO's zijn geladen in de opslag;
• De eerste VM is aangemaakt en geïnstalleerd;
• Qemu Guest Agent is ingeschakeld;
• Back-up is geconfigureerd (vzdump schedule);
• Updates zijn gecontroleerd.

Een server bestellen met Proxmox 9 via API¶

Om deze software te installeren via de API, volg deze instructies.