PVE Guard Hilfe

Verbindung abgelehnt / Timeout

• Stelle sicher, dass dein iPhone im selben Netzwerk wie der Proxmox-Server ist, oder dass der Server aus deinem aktuellen Netzwerk erreichbar ist.
• Überprüfe, ob die URL den richtigen Port enthält (Standard: 8006).
• Prüfe, ob die Proxmox-Weboberfläche im Browser unter derselben URL erreichbar ist.
• Falls eine Firewall aktiv ist, stelle sicher, dass Port 8006 (TCP) offen ist.

Authentifizierung fehlgeschlagen (401)

• Überprüfe das Format der API-Token-ID: benutzer@realm!tokenid (z.B. root@pam!pveguard).
• Stelle sicher, dass das Token-Secret korrekt ist — es wird nur einmal bei der Erstellung angezeigt.
• Falls das Token gerade erstellt wurde, aktualisiere die Proxmox-Weboberfläche, um zu bestätigen, dass es existiert.
• Prüfe, ob "Privilege Separation" wie gewünscht konfiguriert ist.

Zertifikatsfehler

Proxmox verwendet standardmäßig selbstsignierte Zertifikate. PVE Guard behandelt dies, aber es können Probleme auftreten:

• Erste Verbindung: PVE Guard fragt, ob du dem Zertifikat vertrauen möchtest. Tippe auf Vertrauen.
• Zertifikat geändert: Wenn du das Proxmox-Zertifikat ersetzt hast (z.B. durch Let's Encrypt), musst du möglicherweise den Server neu verbinden.
• Reverse Proxy: Wenn ein Reverse Proxy vor Proxmox steht, stelle sicher, dass er die korrekte Zertifikatskette weitergibt.

Fehlende VMs oder Container

• Das API-Token hat möglicherweise nicht die Berechtigung, alle Ressourcen zu sehen. Verwende ein Token mit der Rolle PVEAuditor auf / (Rootpfad) für vollen Lesezugriff.
• Templates werden standardmäßig ausgeblendet — sie erscheinen nicht in der Gästeliste.

VMs können nicht gestartet/gestoppt werden

VM-Aktionen erfordern Schreibrechte. Ein Token mit der Rolle PVEAuditor kann nur überwachen. Verwende ein Token mit der Rolle PVEAdmin oder Administrator, oder deaktiviere "Privilege Separation" bei einem root@pam-Token.

Benachrichtigungen funktionieren nicht

• Stelle sicher, dass Benachrichtigungen in den iOS-Einstellungen für PVE Guard aktiviert sind.
• Prüfe, ob die Hintergrundaktualisierung aktiviert ist: Einstellungen → Allgemein → Hintergrundaktualisierung → PVE Guard.
• iOS kann Hintergrundprüfungen verzögern. Bei geöffneter App kommen Benachrichtigungen innerhalb weniger Minuten.

Weiterhin Probleme?

Kontaktiere uns unter support@hans-renz.de mit einer Beschreibung des Problems und eventuellen Fehlermeldungen.