ProxPulse — Support et FAQ · Support & FAQ

Le token API est la méthode recommandée : il se révoque seul, sans changer votre mot de passe.

Dans l'interface web de Proxmox VE :

1. Datacenter → Permissions → API Tokens → Add.
2. Décochez « Privilege Separation » pour que le token hérite des droits de l'utilisateur, ou laissez-la cochée et attribuez un rôle au token.
3. Rôles conseillés sur le chemin / : PVEAuditor (lecture seule) ou PVEVMAdmin + PVEDatastoreUser (actions sur les VM, snapshots, sauvegardes).
4. Copiez le secret : il n'est affiché qu'une seule fois.

En ligne de commande (sur un nœud Proxmox) :

pveum user add mobile@pve
pveum user token add mobile@pve app -privsep 0
# Rôles conseillés
pveum acl modify / -user mobile@pve -role PVEVMAdmin        # VM/CT, snapshots, migration, config
pveum acl modify / -user mobile@pve -role PVEDatastoreUser  # backups, contenu stockage
pveum acl modify / -user mobile@pve -role PVEAuditor        # lecture nœuds / tâches

Dans l'application, l'identifiant du token est mobile@pve!app (format utilisateur@royaume!nom-du-token), accompagné du secret affiché à la création.

Avec -privsep 0, le token a les mêmes droits que l'utilisateur mobile@pve (c'est pourquoi les rôles sont attribués à l'utilisateur). Accordez le minimum nécessaire.

N'accordez les droits élevés (Sys.PowerMgmt, Sys.Console…) que si vous utilisez la fonction correspondante.

Proxmox génère par défaut un certificat auto-signé, que iOS ne reconnaît pas. Dans le formulaire du serveur, l'option « Accepter un certificat auto-signé » permet de s'y connecter.

Activée, cette option accepte tout certificat sans le vérifier : une personne mal intentionnée située sur le même réseau pourrait se faire passer pour votre serveur. Utilisez-la sur un réseau de confiance ou via un VPN. L'idéal reste un certificat valide (par exemple Let's Encrypt via la fonction ACME de Proxmox), avec l'option désactivée.

N'exposez pas le port 8006 sur Internet. Préférez un VPN (WireGuard, Tailscale…) : connectez votre iPhone au VPN, puis utilisez l'adresse locale du serveur dans ProxPulse.

À défaut, placez un reverse proxy (par exemple Traefik) avec une authentification forte devant l'API. L'adresse saisie peut contenir un chemin, par exemple https://pve.exemple.fr/pve.

Vous pouvez vous connecter avec un utilisateur et son mot de passe (par exemple root@pam). Si le compte a une double authentification, l'application demande le code : TOTP, Yubico OTP ou clé de récupération sont pris en charge. WebAuthn / FIDO2 comme unique second facteur n'est pas pris en charge.

Un compte « mot de passe + double authentification » ne peut pas se reconnecter tout seul (l'application ne peut pas saisir un nouveau code à votre place) : pour la surveillance, préférez un token API.

Proxmox n'expose aucun point d'accès standard pour les sondes de température. ProxPulse les lit donc comme le ferait un administrateur : il ouvre le shell du nœud (le même mécanisme que le bouton « Shell » de l'interface web), exécute une courte commande en lecture seule qui lit /sys/class/hwmon, puis referme la connexion. Rien n'est installé sur le serveur.

Ouvrir le shell d'un nœud exige la permission Sys.Console, qu'en pratique seul root@pam possède : sur un compte non root, le nœud demande un identifiant de connexion et la lecture échoue.

La fonction est désactivée par défaut (Réglages, « Températures des nœuds »). Activez-la seulement si vous acceptez d'utiliser ce niveau d'accès avec ProxPulse. Vous pouvez choisir °C ou °F.

Messages possibles : « Shell du nœud refusé » (droits insuffisants), « Le nœud n'a pas répondu à temps », « Aucun capteur de température trouvé » (le matériel ou la machine virtuelle n'expose rien).

Notifications locales : VM arrêtée, tâche en échec, nœud hors ligne, seuils de stockage et de mémoire. Elles sont calculées sur l'appareil à partir des données de vos serveurs (Réglages → Notifications).

Push via ntfy ou Gotify : c'est le système de notifications de Proxmox qui envoie les messages, même application fermée. ProxPulse se contente de créer la destination dans votre serveur Proxmox.

1. Réglages → Notifications push → Ajouter une destination.
2. Choisissez ntfy ou Gotify, renseignez le serveur (https://ntfy.sh par défaut pour ntfy), puis le sujet ntfy (généré au hasard, long) ou le jeton Gotify. Choisissez les niveaux à notifier.
3. Touchez « Créer la destination », puis « Envoyer un test ».
4. Pour ntfy, abonnez-vous au même sujet dans l'application ntfy (iOS) pour recevoir les messages.

• ntfy nécessite Proxmox VE 8.3 ou plus récent (destinations webhook).
• Droits requis : Mapping.Modify sur /mapping/notifications et Sys.Modify (ou Sys.AccessNetwork) sur /.
• Votre serveur Proxmox doit pouvoir joindre le serveur ntfy ou Gotify.
• Sur ntfy.sh, quiconque connaît le sujet peut lire les messages : gardez-le secret, ou utilisez votre propre serveur ntfy avec un jeton.
• L'application ne contacte jamais ntfy ni Gotify elle-même.
• Les destinations créées par l'application portent le préfixe proxpulse- ; les supprimer depuis l'application retire aussi la règle associée.

Appui long sur l'écran d'accueil → « + » → ProxPulse. Le widget affiche le statut d'un nœud, les machines actives et une machine favorite. Ses données sont fournies par l'application : ouvrez ProxPulse pour les actualiser, ou utilisez Réglages → « Mettre à jour le widget ». Elles restent sur l'appareil.

PBS est pris en charge en lecture seule : datastores, groupes de sauvegarde, vérifications et tâches en échec. Ajoutez-le comme un serveur, avec le port 8007 par défaut de PBS.

1. Dans PBS : Configuration → Access Control → API Token → Add.
2. Donnez au token le rôle Audit (lecture seule) sur /.
3. Copiez le secret, affiché une seule fois.

Sur l'écran d'accueil, tant qu'aucun serveur n'est configuré, touchez « Essayer la démo » : un cluster fictif (3 nœuds, VM et conteneurs, tâches, sauvegardes) est chargé, sans aucun réseau.

La console et l'écran graphique ne sont pas disponibles en démo. Pour quitter la démo : Réglages → Serveurs.

1. Adresse et port : 8006 pour Proxmox VE, 8007 pour Proxmox Backup Server (sauf si vous les avez changés ou si un reverse proxy est utilisé). La connexion se fait toujours en HTTPS.
2. Joignabilité : depuis le navigateur du téléphone, la page https://adresse:8006 doit s'ouvrir. Hors de chez vous, le VPN doit être actif.
3. Réseau local : pour un serveur situé sur votre réseau, autorisez ProxPulse dans Réglages iOS → ProxPulse → Réseau local.
4. Certificat : s'il est auto-signé, activez « Accepter un certificat auto-signé » pour ce serveur.
5. Token : identifiant complet au format utilisateur@royaume!nom (par exemple mobile@pve!app) et secret exact. Vérifiez qu'il n'est pas expiré et que ses droits (ou ceux de l'utilisateur si « Privilege Separation » est décoché) suffisent.
6. Mot de passe : utilisateur avec son royaume (root@pam), et code de double authentification valide (l'heure de l'appareil doit être exacte pour un TOTP).
7. Erreur « 403 » ou « droits insuffisants » : la connexion fonctionne mais le droit manque ; voir les droits par fonction.
8. Pare-feu : le pare-feu de Proxmox ou de votre routeur doit autoriser le port depuis votre appareil.
9. Reverse proxy : si l'API est derrière un chemin, saisissez-le dans l'adresse (https://pve.exemple.fr/pve) et vérifiez que les WebSockets sont transmis (nécessaire à la console).
10. Journal d'erreurs : Réglages → « Widget & diagnostic » → Journal des erreurs. Il reste sur l'appareil ; vous pouvez le copier et le joindre à votre message.

An API token is the recommended method: it can be revoked on its own, without changing your password.

In the Proxmox VE web interface:

1. Datacenter → Permissions → API Tokens → Add.
2. Uncheck “Privilege Separation” so the token inherits the user's privileges, or leave it checked and assign a role to the token.
3. Recommended roles on the path /: PVEAuditor (read-only) or PVEVMAdmin + PVEDatastoreUser (VM actions, snapshots, backups).
4. Copy the secret: it is shown only once.

From the command line (on a Proxmox node):

pveum user add mobile@pve
pveum user token add mobile@pve app -privsep 0
# Recommended roles
pveum acl modify / -user mobile@pve -role PVEVMAdmin        # VM/CT, snapshots, migration, config
pveum acl modify / -user mobile@pve -role PVEDatastoreUser  # backups, storage content
pveum acl modify / -user mobile@pve -role PVEAuditor        # read nodes / tasks

In the app, the token ID is mobile@pve!app (format user@realm!token-name), together with the secret shown at creation.

With -privsep 0, the token has the same privileges as the user mobile@pve (which is why roles are granted to the user). Grant the minimum necessary.

Only grant the high privileges (Sys.PowerMgmt, Sys.Console…) if you use the matching feature.

Proxmox generates a self-signed certificate by default, which iOS does not trust. In the server form, the “Accept self-signed certificate” option lets you connect anyway.

When on, this option accepts any certificate without verifying it: someone malicious on the same network could impersonate your server. Use it on a trusted network or through a VPN. The best setup is a valid certificate (for example Let's Encrypt through Proxmox's ACME feature) with the option turned off.

Do not expose port 8006 to the Internet. Prefer a VPN (WireGuard, Tailscale…): connect your iPhone to the VPN, then use the server's local address in ProxPulse.

Otherwise, put a reverse proxy (for example Traefik) with strong authentication in front of the API. The address you enter may contain a path, for example https://pve.example.com/pve.

You can sign in with a user and password (for example root@pam). If the account has two-factor authentication, the app asks for the code: TOTP, Yubico OTP and recovery keys are supported. WebAuthn / FIDO2 as the only second factor is not supported.

A “password + two-factor” account cannot sign in again on its own (the app cannot type a fresh code for you): for monitoring, prefer an API token.

Proxmox exposes no standard endpoint for temperature sensors. ProxPulse therefore reads them the way an administrator would: it opens the node shell (the same mechanism as the “Shell” button in the web interface), runs a short read-only command that reads /sys/class/hwmon, then closes the connection. Nothing is installed on the server.

Opening a node shell requires the Sys.Console permission, which in practice only root@pam has: with a non-root account the node asks for a login and reading fails.

The feature is off by default (Settings, “Node temperatures”). Turn it on only if you are comfortable using that level of access with ProxPulse. You can choose °C or °F.

Possible messages: “Node shell denied” (not enough permissions), “The node did not answer in time”, “No temperature sensor found” (the hardware or virtual machine exposes none).

Local notifications: VM stopped, failed task, node offline, storage and memory thresholds. They are computed on the device from your servers' data (Settings → Notifications).

Push through ntfy or Gotify: Proxmox's own notification system sends the messages, even when the app is closed. ProxPulse only creates the destination inside your Proxmox server.

1. Settings → Push notifications → Add a destination.
2. Choose ntfy or Gotify, fill in the server (https://ntfy.sh by default for ntfy), then the ntfy topic (random and long) or the Gotify token. Choose the levels to notify.
3. Tap “Create destination”, then “Send a test”.
4. For ntfy, subscribe to the same topic in the ntfy app (iOS) to receive the messages.

• ntfy requires Proxmox VE 8.3 or later (webhook targets).
• Required permissions: Mapping.Modify on /mapping/notifications and Sys.Modify (or Sys.AccessNetwork) on /.
• Your Proxmox server must be able to reach the ntfy or Gotify server.
• On ntfy.sh, anyone who knows the topic can read the messages: keep it secret, or use your own ntfy server with a token.
• The app never contacts ntfy or Gotify itself.
• Destinations created by the app are prefixed proxpulse-; deleting them from the app also removes the matching rule.

Long-press the home screen → “+” → ProxPulse. The widget shows a node's status, the running machines and a favorite machine. Its data is provided by the app: open ProxPulse to refresh it, or use Settings → “Update widget”. The data stays on the device.

PBS is supported in read-only mode: datastores, backup groups, verifications and failed tasks. Add it like a server, using PBS's default port 8007.

1. In PBS: Configuration → Access Control → API Token → Add.
2. Give the token the Audit role (read-only) on /.
3. Copy the secret, shown only once.

On the home screen, while no server is configured, tap “Try the demo”: a fictional cluster (3 nodes, VMs and containers, tasks, backups) is loaded, with no network at all.

The console and the graphical screen are not available in the demo. To leave the demo: Settings → Servers.

1. Address and port: 8006 for Proxmox VE, 8007 for Proxmox Backup Server (unless you changed them or use a reverse proxy). The connection is always HTTPS.
2. Reachability: from the phone's browser, https://address:8006 should open. Away from home, the VPN must be active.
3. Local network: for a server on your own network, allow ProxPulse in iOS Settings → ProxPulse → Local Network.
4. Certificate: if it is self-signed, turn on “Accept self-signed certificate” for that server.
5. Token: full ID in the user@realm!name format (for example mobile@pve!app) and the exact secret. Check it has not expired and that its privileges (or the user's, if “Privilege Separation” is unchecked) are sufficient.
6. Password: user with realm (root@pam), and a valid two-factor code (the device clock must be accurate for a TOTP).
7. “403” or “insufficient permissions”: the connection works but a permission is missing; see permissions by feature.
8. Firewall: the Proxmox firewall or your router must allow the port from your device.
9. Reverse proxy: if the API sits behind a path, enter it in the address (https://pve.example.com/pve) and make sure WebSockets are forwarded (required by the console).
10. Error log: Settings → “Widget & diagnostics” → Error log. It stays on the device; you can copy it and attach it to your message.