Proxmox VM und LXC Konfiguration auf der Bash anzeigen und ändern

Wenn du unter Proxmox die VM Konfiguration anzeigen oder die Einstellungen eines LXC Containers prüfen möchtest, brauchst du nicht zwingend die Weboberfläche. Viele Dinge lassen sich direkt per SSH auf dem Proxmox-Host auslesen. Genau das ist praktisch, wenn du schnell wissen willst, welche CPU, welcher RAM, welche Bridge oder welches Storage einer bestehenden VM oder einem Container zugeordnet ist.

In diesem Beitrag zeige ich dir die wichtigsten Befehle für KVM-VMs und LXC Container. Außerdem schauen wir uns ein paar echte, gekürzte Konfigurationsbeispiele an. Am Anfang gibt es auch einen kurzen Ausflug, wie du per SSH beispielhaft eine VM oder einen LXC erstellst. Nicht, weil man ständig neue Systeme aus dem Terminal werfen sollte. Aber manchmal ist es einfach schneller. Und schneller ist gut, solange man vorher die VMID richtig gelesen hat.

🧭 Per SSH auf den Proxmox-Host verbinden

Die Befehle in diesem Beitrag führst du direkt auf deinem Proxmox-Host aus. Wenn du also nicht bereits lokal auf der Konsole bist, verbindest du dich zuerst per SSH:

ssh root@proxmox-host

Wenn du mit SSH-Aliases arbeitest, geht es natürlich auch kürzer:

ssh pve01

Danach kannst du mit qm für virtuelle Maschinen und pct für LXC Container arbeiten. Die beiden Werkzeuge sind im Alltag wirklich angenehm, weil sie direkt zur Proxmox-Welt gehören und dir nicht erst eine halbe JSON-Tapete vor die Füße werfen.

📋 VM und LXC Container auflisten

Bevor du eine Konfiguration anzeigen kannst, brauchst du die passende ID. Bei Proxmox ist das die VMID. Virtuelle Maschinen listest du mit qm list auf:

qm list

Eine gekürzte Ausgabe kann zum Beispiel so aussehen:

VMID NAME       STATUS   MEM(MB) BOOTDISK(GB)
103  vm-demo    running  12288   64.00
127  mon01      running  4096    64.00
150  backup01   running  2048    32.00

LXC Container listest du mit pct list auf:

pct list
VMID Status   Lock Name
106  running       lxc-demo

Damit hast du schon die wichtigste Information: die ID. Ohne diese ID stochert man nur dekorativ im Terminal herum.

🖥️ Proxmox VM Konfiguration anzeigen

Die Konfiguration einer virtuellen Maschine zeigst du mit qm config an. Dahinter kommt die VMID:

qm config 103

Aus meinem Test sah die Ausgabe gekürzt und anonymisiert so aus:

agent: 1
balloon: 0
bios: ovmf
boot: order=scsi0
cores: 2
cpu: host
efidisk0: vmdata1:103/vm-103-disk-0.raw,efitype=4m,size=528K
localtime: 1
memory: 12288
name: vm-demo
net0: virtio=XX:XX:XX:XX:XX:XX,bridge=vmbr0
onboot: 1
ostype: l26
scsi0: vmdata1:103/vm-103-disk-1.raw,cache=writethrough,size=64G
scsihw: virtio-scsi-pci
tablet: 0
tags: infrastructure;smarthome

Die wichtigsten Zeilen sind meistens schnell gelesen:

  • cores zeigt die Anzahl der CPU-Kerne.
  • memory zeigt den Arbeitsspeicher in Megabyte.
  • scsi0, virtio0 oder ähnliche Einträge zeigen die virtuellen Festplatten.
  • net0 zeigt die Netzwerkkarte, das Modell und die Bridge.
  • onboot sagt dir, ob die VM beim Start des Proxmox-Hosts automatisch gestartet wird.
  • agent zeigt, ob der QEMU Guest Agent für diese VM aktiviert ist.

Gerade net0 und die Disk-Zeilen sind beim Troubleshooting Gold wert. Dort siehst du sofort, ob eine VM auf der erwarteten Bridge hängt und auf welchem Storage die virtuelle Platte liegt.

Status einer VM prüfen

Wenn du zusätzlich wissen möchtest, ob die VM läuft, nutzt du qm status:

qm status 103
status: running

Mit --verbose bekommst du deutlich mehr Laufzeitinformationen, etwa Speicher, I/O und Netzwerkzähler. Das ist nützlich, wenn du gerade ein Problem suchst. Für einen schnellen Blick ist es aber manchmal ein bisschen viel Text. Proxmox ist da nicht schüchtern.

📦 LXC Container Konfiguration anzeigen

Bei LXC Containern funktioniert es ähnlich, nur eben mit pct statt qm. Die Konfiguration eines Containers zeigst du so an:

pct config 106

Eine gekürzte Beispielausgabe:

arch: amd64
cores: 2
features: keyctl=1,nesting=1
hostname: lxc-demo
memory: 2048
nameserver: 1.1.1.1
net0: name=eth0,bridge=vmbr0,gw=10.0.1.1,hwaddr=XX:XX:XX:XX:XX:XX,ip=10.0.1.106/24,type=veth
onboot: 1
ostype: debian
rootfs: vmdata1:106/vm-106-disk-0.raw,size=14G
searchdomain: example.int
swap: 0
tags: infrastructure
unprivileged: 1

Auch hier sind ein paar Zeilen besonders wichtig:

  • hostname ist der Name des Containers.
  • cores und memory zeigen CPU und RAM.
  • rootfs zeigt Storage, Container-ID und Größe des Root-Dateisystems.
  • net0 enthält IP-Adresse, Gateway, Bridge und den veth-Typ.
  • unprivileged: 1 zeigt, dass der Container unprivilegiert läuft.
  • features zeigt aktivierte Zusatzfunktionen wie nesting oder keyctl.

Bei LXC ist unprivileged eine der Zeilen, auf die ich immer schaue. Privilegierte Container können sinnvoll sein, aber sie sind eben auch näher am Host. Wenn du keinen konkreten Grund hast, ist unprivilegiert meistens die angenehmere Antwort.

Status eines LXC Containers prüfen

Den Status eines Containers prüfst du so:

pct status 106
status: running

Wenn der Container läuft und du hinein möchtest, kannst du zusätzlich pct enter verwenden:

pct enter 106

Das ist kein Auslesen der Konfiguration mehr, aber im Alltag sehr praktisch. Gerade wenn du schnell prüfen willst, ob ein Dienst im Container läuft.

🗂️ Konfigurationsdateien direkt lesen

Proxmox legt die Konfigurationen auch als Dateien unter /etc/pve ab. Das ist besonders nützlich, wenn du per grep, Backup-Script oder Monitoring prüfen möchtest, was gesetzt ist.

VM-Konfigurationen liegen hier:

cat /etc/pve/qemu-server/103.conf

LXC-Konfigurationen findest du hier:

cat /etc/pve/lxc/106.conf

Ich nutze zum Anzeigen trotzdem meistens qm config und pct config, weil das die offiziellen Werkzeuge dafür sind. Die Dateien direkt zu lesen ist aber vollkommen okay. Nur beim manuellen Bearbeiten solltest du vorsichtig sein. Schnell mal eine Zeile falsch geändert und schon macht die VM beim nächsten Start Yoga in der Ecke.

🧪 Konfiguration per Proxmox API ausgeben

Für Scripte ist die Proxmox-API interessant. Lokal auf dem Host kannst du dafür pvesh nutzen. Den Node-Namen kannst du mit hostname einsetzen lassen:

pvesh get /nodes/$(hostname)/qemu/103/config --output-format json
pvesh get /nodes/$(hostname)/lxc/106/config --output-format json

Das ist nicht unbedingt schöner für Menschen, aber besser für Maschinen. Wenn du später automatisiert prüfen willst, ob alle wichtigen VMs onboot: 1 gesetzt haben oder ob Container auf der richtigen Bridge hängen, ist das der sauberere Weg.

🚀 Beispiel: LXC Container per SSH erstellen

Wenn du einen LXC Container per SSH erstellen möchtest, brauchst du zuerst ein Template. Welche Templates verfügbar sind, zeigst du so an:

pveam update
pveam available --section system | grep debian

Danach lädst du das gewünschte Template herunter. Der genaue Dateiname ändert sich mit der Zeit, deshalb nimmst du den Namen aus deiner Ausgabe. Hier ist ein Beispiel:

TEMPLATE="debian-12-standard_12.7-1_amd64.tar.zst"
pveam download local "$TEMPLATE"

Ein einfacher Container kann dann so erstellt werden:

pct create 120 "local:vztmpl/${TEMPLATE}" \
  --hostname demo-lxc \
  --cores 2 \
  --memory 2048 \
  --rootfs vmdata1:8 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp \
  --unprivileged 1 \
  --features nesting=1 \
  --onboot 1

Starten würdest du ihn anschließend so:

pct start 120

Wichtig: Passe VMID, Storage, Bridge und Template-Dateiname an deine Umgebung an. Gerade Storage-Namen wie local, local-lvm oder vmdata1 sind je nach Installation unterschiedlich.

🛠️ Beispiel: VM per SSH erstellen

Eine VM per SSH zu erstellen ist etwas umfangreicher, weil du meistens noch ein Installationsmedium oder ein Cloud-Image einbindest. Ein simples Grundgerüst sieht so aus:

qm create 121 \
  --name demo-vm \
  --memory 4096 \
  --cores 2 \
  --cpu host \
  --net0 virtio,bridge=vmbr0 \
  --scsihw virtio-scsi-pci \
  --ostype l26 \
  --agent 1 \
  --onboot 1

Danach fügst du eine virtuelle Festplatte hinzu:

qm set 121 --scsi0 vmdata1:32

Wenn du per ISO installieren möchtest, bindest du das ISO als CD-ROM ein. Der ISO-Dateiname ist nur ein Beispiel:

qm set 121 --ide2 local:iso/debian-12-netinst-amd64.iso,media=cdrom
qm set 121 --boot "order=scsi0;ide2"

Starten kannst du die VM danach mit:

qm start 121

Für produktive VMs würde ich mir die Befehle immer vorher in Ruhe zurechtlegen. Eine falsche VMID ist schnell getippt, und Proxmox nimmt dich beim Wort. Terminale sind da manchmal unangenehm konsequent.

🔎 Praktische Filter für den Alltag

Wenn du nur bestimmte Werte sehen möchtest, kannst du die Ausgabe einfach filtern. Zum Beispiel alle Netzwerkeinstellungen einer VM:

qm config 103 | grep '^net'

Oder die Netzwerkeinstellungen eines LXC Containers:

pct config 106 | grep '^net'

Auch Autostart lässt sich schnell prüfen:

qm config 103 | grep '^onboot'
pct config 106 | grep '^onboot'

Das ist vor allem nach Umzügen, Restores oder kleinen Aufräumaktionen hilfreich. Manchmal wundert man sich, warum nach einem Reboot etwas fehlt. Und dann steht da trocken onboot: 0. Danke für nichts, Vergangenheit.

🧯 Typische Fehler und Stolperfallen

  • Falsche VMID: Erst mit qm list oder pct list prüfen, dann ausführen.
  • VM und LXC verwechselt: qm ist für KVM-VMs, pct ist für LXC Container.
  • Storage-Name passt nicht: Beispiele wie vmdata1 musst du an deine Umgebung anpassen.
  • Bridge nicht vorhanden: vmbr0 ist häufig, aber nicht garantiert. Prüfe deine Bridges im Proxmox-Netzwerk.
  • Direkte Dateibearbeitung: Anzeigen ist harmlos. Manuelles Bearbeiten unter /etc/pve sollte bewusst passieren.

Wenn du nur lesen möchtest, sind qm config und pct config die angenehmsten Befehle. Sie ändern nichts, sie starten nichts, sie löschen nichts. Genau mein Lieblingsmodus, wenn ich erstmal verstehen will, was vor mir liegt.

✅ Fazit

Wenn du unter Proxmox die Konfiguration einer VM anzeigen möchtest, ist qm config VMID der direkte Weg. Für LXC Container nutzt du pct config VMID. Dazu kommen qm list, pct list und bei Bedarf die Dateien unter /etc/pve.

Für mich gehören diese Befehle zu den kleinen Proxmox-Werkzeugen, die man ruhig im Kopf (oder aufgeschrieben) haben darf. Sie helfen beim Dokumentieren, beim Troubleshooting und beim schnellen Gegencheck nach Änderungen. Und das Beste daran: Du kannst erstmal alles ansehen, bevor du irgendetwas anfasst. In der Admin-Welt ist das manchmal schon die halbe Miete.

💬 Techniverse Community

Lust auf Austausch rund um Matrix, Selfhosting und andere smarte IT-Lösungen?
In der Techniverse Community triffst du Gleichgesinnte, kannst Fragen stellen oder einfach nerdigen Talk genießen.

Jetzt der Gruppe auf Matrix beitreten
~ Direkte Raumadresse: #community:techniverse.net

Für lockere Gespräche abseits der Kernthemen komm in den Talkraum
~ Direkte Raumadresse: #talk:techniverse.net

Wir freuen uns, wenn du dabei bist!

Vielen Dank fürs Teilen!