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:
coreszeigt die Anzahl der CPU-Kerne.memoryzeigt den Arbeitsspeicher in Megabyte.scsi0,virtio0oder ähnliche Einträge zeigen die virtuellen Festplatten.net0zeigt die Netzwerkkarte, das Modell und die Bridge.onbootsagt dir, ob die VM beim Start des Proxmox-Hosts automatisch gestartet wird.agentzeigt, 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:
hostnameist der Name des Containers.coresundmemoryzeigen CPU und RAM.rootfszeigt Storage, Container-ID und Größe des Root-Dateisystems.net0enthält IP-Adresse, Gateway, Bridge und den veth-Typ.unprivileged: 1zeigt, dass der Container unprivilegiert läuft.featureszeigt aktivierte Zusatzfunktionen wienestingoderkeyctl.
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 listoderpct listprüfen, dann ausführen. - VM und LXC verwechselt:
qmist für KVM-VMs,pctist für LXC Container. - Storage-Name passt nicht: Beispiele wie
vmdata1musst du an deine Umgebung anpassen. - Bridge nicht vorhanden:
vmbr0ist häufig, aber nicht garantiert. Prüfe deine Bridges im Proxmox-Netzwerk. - Direkte Dateibearbeitung: Anzeigen ist harmlos. Manuelles Bearbeiten unter
/etc/pvesollte 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!



