Proxmox setup de base

Proxmox setup de base

Nicolas Schmid Lv3
  17.06.2026 07:36 17.06.2026 07:36 Created   24.06.2026 06:29:03 24.06.2026 06:29:03 Updated  

Configurations à effectuer avant d’utiliser Proxmox dans un homelab

Dépôts APT Community

Pour utiliser Proxmox sans abonnement, supprimer les dépôts Enterprise inutiles :

1
2
rm /etc/apt/sources.list.d/ceph.sources
rm /etc/apt/sources.list.d/pve-enterprise.sources

Ajouter ensuite le dépôt APT Community :

1
nano /etc/apt/sources.list.d/pve-no-subscription.sources

Contenu :

1
2
3
4
5
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Mettre ensuite le système entièrement à jour :

1
apt update && apt full-upgrade -y && apt autoremove -y && apt autoclean

Optimisation ZFS sous Proxmox

Désactiver atime

Désactiver atime afin d’éviter l’écriture inutile des timestamps d’accès à chaque lecture :

1
zfs set atime=off rpool

Upload des ISO

Si l’upload ne fonctionne pas via la WebUI, il est possible de copier directement les ISO dans le répertoire suivant :

1
/var/lib/vz/template/iso

PCI Passthrough & VFIO

Toutes les étapes nécessaires pour passer proprement un périphérique PCI Express à une machine virtuelle.

Activer l’IOMMU via cmdline

Modifier les paramètres de démarrage :

1
nano /etc/kernel/cmdline

Contenu du fichier avec l’IOMMU activé :

1
root=ZFS=rpool/ROOT/pve-1 boot=zfs intel_iommu=on iommu=pt pcie_acs_override=downstream,multifunction

Rafraîchir le bootloader :

1
proxmox-boot-tool refresh

Activer l’IOMMU via GRUB

Modifier les paramètres de démarrage :

1
nano /etc/default/grub

Contenu du fichier avec l’IOMMU activé :

1
2
3
4
5
GRUB_DEFAULT=0
GRUB_TIMEOUT=5
GRUB_DISTRIBUTOR=`( . /etc/os-release && echo ${NAME} )`
GRUB_CMDLINE_LINUX_DEFAULT="quiet intel_iommu=on iommu=pt"
GRUB_CMDLINE_LINUX="intel_iommu=on iommu=pt"

Mettre à jour GRUB :

1
update-grub

Activer les modules VFIO

Sous Proxmox VE 9.2 :

1
nano /etc/modules-load.d/modules.conf

Contenu :

1
2
3
4
5
6
7
8
9
# /etc/modules is obsolete and has been replaced by /etc/modules-load.d/.
# Please see modules-load.d(5) and modprobe.d(5) for details.
#
# Updating this file still works, but it is undocumented and unsupported.

vfio
vfio_iommu_type1
vfio_pci
vfio_virqfd

Associer les périphériques PCIe au module VFIO

Cette étape permet de forcer l’utilisation des pilotes VFIO au démarrage et d’empêcher le chargement des pilotes par défaut.

Identifier les identifiants PCI :

1
lspci -nn

Exemple avec une carte graphique NVIDIA et plusieurs SSD NVMe Samsung :

1
2
3
4
5
6
7
8
99:00.0 VGA compatible controller [0300]: NVIDIA Corporation TU116 [GeForce GTX 1660 SUPER] [10de:21c4] (rev a1)
99:00.1 Audio device [0403]: NVIDIA Corporation TU116 High Definition Audio Controller [10de:1aeb] (rev a1)
99:00.2 USB controller [0c03]: NVIDIA Corporation TU116 USB 3.1 Host Controller [10de:1aec] (rev a1)
99:00.3 Serial bus controller [0c80]: NVIDIA Corporation TU116 USB Type-C UCSI Controller [10de:1aed] (rev a1)

2d:00.0 Non-Volatile memory controller [0108]: Samsung Electronics Co Ltd NVMe SSD Controller PM9C1a (DRAM-less) [144d:a80d]
2e:00.0 Non-Volatile memory controller [0108]: Samsung Electronics Co Ltd NVMe SSD Controller PM9C1a (DRAM-less) [144d:a80d]
2f:00.0 Non-Volatile memory controller [0108]: Samsung Electronics Co Ltd NVMe SSD Controller PM9C1a (DRAM-less) [144d:a80d]

Ajouter les identifiants dans la configuration VFIO.

⚠️ Attention : dans cet exemple, tous les SSD NVMe possèdent le même identifiant (144d:a80d). Ils seront donc tous associés au pilote VFIO.

1
nano /etc/modprobe.d/vfio.conf

Contenu :

1
options vfio-pci ids=10de:21c4,10de:1aeb,10de:1aec,10de:1aed,144d:a80d

Redémarrer Proxmox puis vérifier le pilote utilisé :

1
lspci -k

Exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
99:00.0 VGA compatible controller: NVIDIA Corporation TU116 [GeForce GTX 1660 SUPER] (rev a1)
        Subsystem: ASUSTeK Computer Inc. Device 8752
        Kernel driver in use: vfio-pci
        Kernel modules: nvidiafb, nouveau, nova_core

99:00.1 Audio device: NVIDIA Corporation TU116 High Definition Audio Controller (rev a1)
        Subsystem: ASUSTeK Computer Inc. Device 8752
        Kernel driver in use: vfio-pci
        Kernel modules: snd_hda_intel

99:00.2 USB controller: NVIDIA Corporation TU116 USB 3.1 Host Controller (rev a1)
        Subsystem: ASUSTeK Computer Inc. Device 8752
        Kernel driver in use: vfio-pci
        Kernel modules: xhci_pci

99:00.3 Serial bus controller: NVIDIA Corporation TU116 USB Type-C UCSI Controller (rev a1)
        Subsystem: ASUSTeK Computer Inc. Device 8752
        Kernel driver in use: vfio-pci
        Kernel modules: i2c_nvidia_gpu

2d:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller PM9C1a (DRAM-less)
        Subsystem: Samsung Electronics Co Ltd Device a801
        Kernel driver in use: vfio-pci
        Kernel modules: nvme

2e:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller PM9C1a (DRAM-less)
        Subsystem: Samsung Electronics Co Ltd Device a801
        Kernel driver in use: vfio-pci
        Kernel modules: nvme

2f:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller PM9C1a (DRAM-less)
        Subsystem: Samsung Electronics Co Ltd Device a801
        Kernel driver in use: vfio-pci
        Kernel modules: nvme

Blacklister les pilotes inutiles

Pour une carte graphique NVIDIA passée en VFIO, ces pilotes ne sont généralement plus nécessaires :

1
nano /etc/modprobe.d/blacklist.conf

Contenu :

1
2
3
blacklist nouveau
blacklist nvidia
blacklist nvidiafb

Reconstruire l’initramfs :

1
rebuild initramfs

Optimisations réseau VirtIO

Quelques recommandations pour atteindre les meilleures performances réseau avec des VM utilisant VirtIO ou du passthrough VFIO :

  1. Utiliser le pilote VirtIO et éviter les autres modèles de cartes réseau.
  2. Configurer le Multiqueue à 8 ou 16 selon le nombre de cœurs du CPU hôte.
  3. Utiliser un MTU 9000 sur les bridges et interfaces réseau, particulièrement pour NFS et iSCSI.
  4. Augmenter les buffers TCP maximum :
1
2
3
4
net.core.rmem_max=134217728
net.core.wmem_max=134217728
net.ipv4.tcp_rmem=4096 87380 134217728
net.ipv4.tcp_wmem=4096 65536 134217728
  1. Configurer le serveur NFS avec 32 threads au lieu du mode automatique.

Arrangement des coeurs NUMA

Le serveur possède 2 sockets ayant chacuns leur RAM proche et leur PCIExpress proche, mon objectif est d’avoir le maximum de performance en assigant des coeurs bien précis à mes VMs.

Pour connaitre la structure NUMA de son serveur, il faut aller chercher les propriétés du CPU:

1
lscpu

Dans ce résultat se trouve la topologie NUMA (extrait):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
CPU(s):                      80
  On-line CPU(s) list:       0-79
Vendor ID:                   GenuineIntel
  Model name:                Intel(R) Xeon(R) Gold 6230 CPU @ 2.10GHz
    CPU family:              6
    Model:                   85
    Thread(s) per core:      2
    Core(s) per socket:      20
    Socket(s):               2

NUMA:
  NUMA node(s):              2
  NUMA node0 CPU(s):         0-19,40-59
  NUMA node1 CPU(s):         20-39,60-79

Avec ceci, je conseille de faire une feuille excel pour planifier exactement quelle VM aura quels affinité. La règle d’or est de ne PAS générer de trafic inter-socket inutile, donc garder une machine sur 1 seul socket dans la mesure du possible.

Aussi, l’emplacement des appareils PCI est un argument. Pour savoir quelle topologie PCI a le serveur, cette commadne génère un graphique:

1
lstopo-no-graphics --no-legend --of txt

Structure NUMA

Sur ce schéma il est vislble que les disques SATA ainsi que les NVME sont sur le socket0 et que la GPU ainsi que les cartes réseau haute performance sur le socket1

  • srv-proxmox-01 : 4 vCPU Affinité NUMA node0 0-3
  • srv-truenas-01 : 28 vCPU Affinité NUMA node0 4-19,48-59
  • srv-ubuntu-01 : 40 vCPU (un socket entier) Affinité NUMA node1 20-39,60-79
  • fw-opnsense-01: 8 vCPU Affinité NUMA node0 40-47

Avec cette structure, on évite au mieux le trafic inter-socket et raproche le plus possible les VM de leurs appareils PCIe.

Intel X520

Super carte réseau mais limite fortement les connecteurs SFP+ étant compatibles, pour l’instant j’ai testé cette technique qui a marché sous OpnSsense FreeBSD:

1
2
echo "hw.ix.unsupported_sfp=1" > /boot/loader.conf.d/ix.conf
reboot

Cette commande a été trouvée sur ce poste, indiquant aussi comment réécrire l’EPROM de la carte réseau pour rendre ce paramètre persistent:

Fixing unsupported SFP+ module X520

  • Title: Proxmox setup de base
  • Author: Nicolas Schmid
  • Created at : 17.06.2026 07:36:00
  • Updated at : 24.06.2026 06:29:03
  • Link: https://doc.spacesdata.net/2026/06/17/Proxmox-setup-de-base/
  • License: This work is licensed under CC BY-NC-SA 4.0.
On this page
Proxmox setup de base
  1. Dépôts APT Community
  2. Optimisation ZFS sous Proxmox
    1. Désactiver atime
  3. Upload des ISO
  • PCI Passthrough & VFIO
    1. Activer l’IOMMU via cmdline
    2. Activer l’IOMMU via GRUB
    3. Activer les modules VFIO
    4. Associer les périphériques PCIe au module VFIO
    5. Blacklister les pilotes inutiles
  • Optimisations réseau VirtIO
  • Arrangement des coeurs NUMA
  • Intel X520