# KB - Virtualisation - Proxmox VE

# KB-Proxmox VE - Changer les paramètres réseaux en CLI

<p class="callout info">Applicable à : Proxmox VE 8.3-1</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Après déploiement d'un template proxmox VE et suite à un changement de réseau, l'interface web n'est plus joignable.

---

### <span style="text-decoration: underline;">Problème</span>

l'Adresse DHCP a été fixée dans la configuration lors de l'installation et celle-ci ne fonctionne pas dans le contexte de déploiement.

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">Prérequis : Avoir accès à la console de la machine.</p>

Se connecter dans le terminal avec le compte root et le mot de passe défini lors de l'installation.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/zZBimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/zZBimage-png.png)

Éditer la configuration réseau.

```bash
vi /etc/network/interfaces
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/3P1image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/3P1image-png.png)

Étant donné que l'interface web base sa configuration sur le fichier '<span style="color: rgb(132,63,161);">***hosts***</span>'. Il est également nécessaire de modifier celui-ci.

```bash
vi /etc/hosts
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/z4mimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/z4mimage-png.png)

Une fois les modifications terminées, il faudra redémarrer la machine pour qu'elles soient prises en compte.

l'interface web sera désormais accessible sur la nouvelle adresses spécifiée.

---

### <span style="text-decoration: underline;">Sources</span>

*n/a*

# KB-Proxmox VE - Corriger problèmes d'interface web suite à importation de certificat

<p class="callout info">Applicable à : Proxmox VE &gt;= 8</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Suite au changement de certificat, l'interface web est censée redémarrer, mais celle-ci est injoignable.

---

### <span style="text-decoration: underline;">Problème</span>

Il y a eu un soucis dans l'application des certificats, ou ceux-ci n'ont pas été correctement générés.

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">**Prérequis** : accès au shell de la machine en direct ou en SSH.</p>

Vérifier l'état des services liés à l'interface web et l'api :

```
systemctl status pveproxy
```

Vérifier également l'état des services suivants ci nécessaire :

- pvedaemon
- pveproxy
- pvestatd
- pvescheduler

Si après relance, les services ne sont toujours pas accessibles, cela signifie que les certificats posent problème et qu'il faut forcer le proxmox à régénérer un certificat autosigné.

```
mv /etc/pve/local/pveproxy-ssl.pem /etc/pve/local/pveproxy-ssl.pem.bak
mv /etc/pve/local/pveproxy-ssl.key /etc/pve/local/pveproxy-ssl.key.bak
systemctl restart pveproxy
```

l'Interface web devrait maintenant être de nouveau accessible.

---

### <span style="text-decoration: underline;">Sources</span>

<span style="background-color: rgb(251,238,184);">  
</span>

[\[SOLVED\] - Unable to access web interface after updating certificate | Proxmox Support Forum](https://forum.proxmox.com/threads/unable-to-access-web-interface-after-updating-certificate.130831/)

# KB-Proxmox VE - Désinstaller / réinitialiser CEPH

<p class="callout info">Applicable à : proxmox VE 8.0+</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Un problème est survenu, rendant CEPH inopérant.

---

### <span style="text-decoration: underline;">Problème</span>

Corruption des données du quorum, problème sur le volume, etc...

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">Prérequis : Access au Shell (via a console web ou en direct).</p>

Sur tous les nœuds du cluster, exécuter les commandes suivantes.

```bash
systemctl stop ceph-mon.target
systemctl stop ceph-mgr.target
systemctl stop ceph-mds.target
systemctl stop ceph-osd.target

rm -rf /etc/systemd/system/ceph*

killall -9 ceph-mon ceph-mgr ceph-mds

rm -rf /var/lib/ceph/mon/ /var/lib/ceph/mgr/ /var/lib/ceph/mds/

pveceph purge

apt purge ceph-mon ceph-osd ceph-mgr ceph-mds -y
apt purge ceph-base ceph-mgr-modules-core -y

rm -rf /etc/ceph/*
rm -rf /etc/pve/ceph.conf
rm -rf /etc/pve/priv/ceph.*

lvremove -y /dev/ceph*
vgremove -y ceph-<press-tab-for-bash-completion>
pvremove /dev/nvme1n1

mv /var/lib/ceph/bootstrap-osd /var/lib/ceph/bootstrap-osd.old
mkdir /var/lib/ceph/bootstrap-osd
chown ceph /var/lib/ceph/* -R
```

---

### <span style="text-decoration: underline;">Sources</span>

[\[SOLVED\] - Help! Ceph access totally broken | Proxmox Support Forum](https://forum.proxmox.com/threads/help-ceph-access-totally-broken.162624/)

# KB-Proxmox VE - Remonter des volumes non reconus

<p class="callout info">**Applicable** **à** : Proxmox VE 7+</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Le message suivant apparaît :

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/xdOimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/xdOimage-png.png)

Et des points d'interrogations sont présents les volumes, voire également les VM.

---

### <span style="text-decoration: underline;">Problème</span>

Un problème empêche le montage des volumes PVE.

Il faut lancer une réparation du volume.

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">Prérequis : accès à la console par l'interface web ou directement sur le nœud physique.</p>

Utiliser la commande suivante pour lancer une réparation du volume.

```
lvconvert --repair -v pve/data
```

---

### <span style="text-decoration: underline;">Sources</span>

<span style="background-color: rgb(251,238,184);">Donner les liens vers les sites ou topics qui ont servis à résoudre le problème.  
</span>

# KB-Proxmox VE - résoudre erreur "disk partition has holder"

<p class="callout info">Applicable à : Proxmox VE 8.0+</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Après ajout d'un disque déjà utilisé ailleurs sur un proxmox, lorsque l'on essaye de créer un système de fichier ou de cliquer sur "***Wipe disk***", l'erreur suivante apparaît :

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/E60image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/E60image-png.png)

---

### <span style="text-decoration: underline;">Problème</span>

Lorsqu'un disque a précédemment été utilisé avec LVM, celui-ci créée une signature sur le disque et ajoute un verrou.

Si ce verrou n'a pas été correctement retiré avant la réutilisation du disque, cette erreur apparaît.

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">Prérequis : Accès au shell (localement ou à travers l'interface web)</p>

Exécuter la commande suivante :

```bash
lsblk
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/uRGimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/uRGimage-png.png)

Les volumes présents sont visibles. Il va falloir tous les supprimer.

```bash
dmsetup remove <nom du lv ou vg>
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/oQ0image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/oQ0image-png.png)

Une fois tout retiré, dans l'interface web, recharger l'affichage des disques et cliquer "***Wipe Disk***".

Il est maintenant possible d'allouer de l'espace.

---

### <span style="text-decoration: underline;">Sources</span>

[Proxmox – disk partition has a holder – DIY-Viking](https://www.diy-viking.com/proxmox-disk-partition-has-a-holder/#:~:text=Sometimes%20when%20trying%20to%20wipe%20a%20disk%20in,be%20removed%20before%20the%20disk%20can%20be%20wiped.)

# KB-Proxmox VE - bloqué sur le boot lors de l'installation

<p class="callout info">Applicable à : Proxmox VE</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Lors du démarrage et du lancement de l'installation, le démarrage reste bloqué sur ce message.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Wu8image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Wu8image-png.png)

---

### <span style="text-decoration: underline;">Problème</span>

Certains drivers chargés au démarrage ne sont pas compatibles.

Ici, le problème est au niveau des driver du GPU nvidia non pris en charge.

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">Prérequis : accès à la console et à un clavier.</p>

Démarrer sur le support d'installation.

Sélectionner '<span style="color: rgb(132,63,161);">***Install Proxmox VE (Terminal UI)**'*</span>

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/pllimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/pllimage-png.png)

Appuyer sur '<span style="color: rgb(132,63,161);">***e***</span>' pour éditer les options de démarrage.

Sur l'écran suivant, repérer la ligne commençant par '<span style="color: rgb(132,63,161);">***linux***</span>'

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Y8Gimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Y8Gimage-png.png)

A la fin de la ligne, ajouter '<span style="color: rgb(132,63,161);">***nomodeset***</span>'

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/0xzimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/0xzimage-png.png)

Appuyer sur '<span style="color: rgb(132,63,161);">***F10***</span>' pour démarrer le système avec les options sélectionnées.

---

### <span style="text-decoration: underline;">Sources</span>

Documentation Proxmox : [https://pve.proxmox.com/wiki/Installation#nomodeset\_kernel\_param](https://pve.proxmox.com/wiki/Installation#nomodeset_kernel_param)

# KB-ProxmoxVE - Débloquer machine figée

<p class="callout info">Applicable à : Proxmox &gt; 6.0</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

Une VM est figée et ne peux plus ni être allumée, ni être éteinte.

Cela se matérialise par un panneau jaune sur la VM

---

### <span style="text-decoration: underline;">Problème</span>

La cause principale est une interruption du processus de la VM qui l'a fait passer en processus zombie.

Cette cause peut être due à :

- Un remplissage du datastore contenant la VM, entraînant une corruption de son fichier mémoire et de facto une interruption de son process.
- Une défaillance matérielle ou un démontage du datastore entraînant une accessibilité des fichiers de la VM et donc, une interruption de son process.

---

### <span style="text-decoration: underline;">Solution</span>

<p class="callout danger">Prérequis : Accès à la console du nœud proxmox sur lequel la machine tourne.</p>

Avant de pouvoir manipuler la VM afin de résoudre la cause racine, il va falloir tuer son process pour libérer les fichiers verrouillés.

Pour cela, se connecter à la console proxmox.

Identifier sur quel nœud la VM tourne :

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/H6rimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/H6rimage-png.png)

Sur le nœud en question, ouvrir la console

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/mImimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/mImimage-png.png)

Lister les processus avec la commande :

```bash
ps -efww | grep <vm id>
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/c27image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/c27image-png.png)

Récupérer l'ID du processus, ici :

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/6iIimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/6iIimage-png.png)

Puis tuer le processus avec :

```bash
kill -9 <process ID>
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/eiZimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/eiZimage-png.png)

La machine est donc maintenant arrêtée.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/2l5image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/2l5image-png.png)

---

### <span style="text-decoration: underline;">Sources</span>

**[Proxmox VE Documentation Index](https://pve.proxmox.com/pve-docs/)**

# KB-ProxmoxVE - Débloquer machine en HA failure

<p class="callout info">Applicable à : Proxmox VE 8+</p>

### <span style="text-decoration: underline;">Symptôme(s)</span>

La machine apparaît avec un croix rouge et il est impossible de la démarrer.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/k5Zimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/k5Zimage-png.png)

Lors d'une tentative de démarrage, le message suivant apparaît :

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/kbsimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/kbsimage-png.png)

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/9n2image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/9n2image-png.png)

---

### <span style="text-decoration: underline;">Problème</span>

Cela n'arrive que sur les machines dont la case '<span style="color: rgb(132,63,161);">***Enable HA***</span>' à été cochée lors de la création.

L'état HA de la machine est en erreur.

---

### <span style="text-decoration: underline;">Solution</span>

Il y a deux solutions pour débloquer ce problème. En GUI et en CLI.

<details id="bkmrk-en-gui-aller-sur-le-"><summary>En GUI</summary>

Aller sur le cluster.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/jREimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/jREimage-png.png)

Dans la section du menu '<span style="color: rgb(132,63,161);">***HA***</span>'.

Cliquer sur la machine bloquée, puis sur '<span style="color: rgb(132,63,161);">***Edit***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/NsAimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/NsAimage-png.png)

Changer le '<span style="color: rgb(132,63,161);">***Request State***</span>' en '<span style="color: rgb(132,63,161);">***disabled***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/hvCimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/hvCimage-png.png)

Une fois la machine purgée des flags HA :

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/HqNimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/HqNimage-png.png)

La machine n'apparaît plus en erreur et peut être réutilisée.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/bxTimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/bxTimage-png.png)

La HA pourra être réactivé plus tard.

</details><details id="bkmrk-en-cli-pr%C3%A9requis-%3A-a"><summary>En CLI</summary>

<p class="callout danger">Prérequis : Accès à la console du nœud proxmox en root.</p>

Ouvrir une console sur le nœud proxmox sur lequel se trouve la VM en échec.

Entrer la commande suivante pour désactiver la HA sur la machine :

```
ha-manager set vm:<VMID> --state disabled
```

La machine devrait nettoyer les flags HA et le désactiver. Ce qui rends de nouveau la machine utilisable.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/bxTimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/bxTimage-png.png)

</details>---

### <span style="text-decoration: underline;">Sources</span>

[https://pve.proxmox.com/pve-docs-8/chapter-ha-manager.html](https://pve.proxmox.com/pve-docs-8/chapter-ha-manager.html)

[https://www.youtube.com/watch?v=H4TWUhgmWa4](https://www.youtube.com/watch?v=H4TWUhgmWa4)

[https://forum.proxmox.com/threads/vm-error-state.91523/](https://forum.proxmox.com/threads/vm-error-state.91523/)