Installer Incus sur Debian ou Ubuntu (dépôt Zabbly)

Incus est le gestionnaire de conteneurs système et de machines virtuelles issu du fork de LXD. Ce guide l'installe en quelques minutes sur Debian ou Ubuntu, via le dépôt Zabbly signé (pour avoir la dernière LTS 7.0) ou le paquet natif de la distribution. Il couvre ensuite l'initialisation (incus admin init) et l'accès sans sudo. Tout a été testé sur Debian 13 (Incus 7.0.0). Pour administrateurs et homelabbers qui débutent avec Incus.

Ce que vous allez apprendre

• Installer Incus depuis le dépôt Zabbly ou le paquet natif.
• Initialiser le démon avec incus admin init.
• Utiliser Incus sans sudo (groupe incus-admin).
• Vérifier l'installation en lançant un premier conteneur.

Prérequis

• Une machine Debian 12/13 ou Ubuntu 22.04/24.04 (physique, VM ou cloud).
• Un noyau récent (cgroups v2, namespaces) : tout Debian/Ubuntu actuel convient.
• Pour faire tourner aussi des VMs Incus : la virtualisation matérielle (VT-x/AMD-V) doit être disponible (et le nested-virt activé si la machine est elle-même une VM).

Méthode 1 : le dépôt Zabbly (recommandé)

Zabbly est la société de Stéphane Graber (créateur d'Incus) qui empaquette les versions officielles. C'est la voie recommandée pour disposer de la dernière LTS (7.0), plus récente que le paquet de la distribution.

1. Ajouter la clé de signature du dépôt :

   sudo mkdir -p /etc/apt/keyrings/
   sudo wget -qO /etc/apt/keyrings/zabbly.asc https://pkgs.zabbly.com/key.asc

   Vérifiez l'empreinte (elle doit correspondre à celle publiée par Zabbly) :

   gpg --show-keys --fingerprint /etc/apt/keyrings/zabbly.asc
   # 4EFC 5906 96CB 15B8 7C73  A3AD 82CC 8797 C838 DCFD

2. Déclarer le dépôt LTS 7.0 (format DEB822). Le Suites reprend le nom de code de votre distribution :

   sudo tee /etc/apt/sources.list.d/zabbly-incus-lts-7.0.sources <<EOF
   Enabled: yes
   Types: deb
   URIs: https://pkgs.zabbly.com/incus/lts-7.0
   Suites: $(. /etc/os-release && echo ${VERSION_CODENAME})
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-By: /etc/apt/keyrings/zabbly.asc
   EOF

3. Installer Incus :

   sudo apt update
   sudo apt install incus

Canaux disponibles

Zabbly propose trois canaux : stable (dernière feature release, mensuelle), lts-7.0 (recommandé en production) et lts-6.0 (LTS précédente, supportée jusqu'en 2029). Remplacez lts-7.0 dans l'URL et le nom de fichier pour changer de canal.

Méthode 2 : le paquet natif de la distribution

Depuis Debian 13 et Ubuntu 24.04, Incus est packagé dans les dépôts officiels. C'est plus simple, mais la version est figée par la distribution (souvent une LTS plus ancienne).

Debian 13 / Ubuntu 24.04

sudo apt update
sudo apt install incus

Alpine

# incus-client pour la CLI seule, incus-vm pour le support des VMs
sudo apk add incus incus-client incus-vm

Choisissez cette méthode pour une installation simple et figée ; le dépôt Zabbly si vous voulez suivre la LTS la plus récente.

Initialiser Incus

Avant le premier usage, le démon doit être initialisé : il crée un pool de stockage et un réseau. L'option --auto applique des défauts sensés (stockage dir, réseau incusbr0 en NAT) :

sudo incus admin init --auto

Pour un contrôle fin (backend ZFS/btrfs, taille du pool, réseau), lancez incus admin init sans --auto : un assistant interactif vous pose chaque question.

Évitez le regret du backend dir

--auto retombe sur le backend dir s'il ne trouve pas mieux, et beaucoup l'acceptent sans réfléchir. Or la doc le qualifie de « dernier recours » : pas de snapshots ni de clones rapides (chaque opération recopie tout le rootfs), pas de quotas. Si vous comptez snapshoter, choisissez ZFS dès l'init (apt install zfsutils-linux au préalable) : changer de backend ensuite impose de recréer le pool et migrer les instances.

Vérifiez que le démon répond et que le réseau et le stockage sont créés :

incus network list
# | incusbr0 | bridge | YES | 10.x.x.1/24 | ... | CREATED |
incus storage list
# | default | dir | ... | CREATED |

Utiliser Incus sans sudo

Par défaut, seul root parle au démon. C'est le piège n°1 après l'installation : sans cette étape, chaque commande renvoie un permission denied. Notez que l'install crée deux groupes, incus (usage basique) et incus-admin (contrôle total). Ajoutez votre utilisateur à incus-admin pour piloter Incus sans sudo :

sudo usermod -aG incus-admin "$USER"
newgrp incus-admin   # ou se déconnecter/reconnecter

incus-admin = accès root de fait

Appartenir à incus-admin donne un contrôle total sur Incus, donc indirectement sur l'hôte (montages, devices privilégiés). Ne l'accordez qu'à des utilisateurs de confiance.

Vérifier : lancer un premier conteneur

L'installation est bonne si vous pouvez lancer un conteneur. La sortie réelle sur le lab :

incus version
# Client version: 7.0.0
# Server version: 7.0.0

incus launch images:debian/13 test
incus list

+------+---------+----------------------+------+-----------+-----------+
| NAME |  STATE  |         IPV4         | IPV6 |   TYPE    | SNAPSHOTS |
+------+---------+----------------------+------+-----------+-----------+
| test | RUNNING | 10.173.191.x (eth0)  |      | CONTAINER | 0         |
+------+---------+----------------------+------+-----------+-----------+

Le conteneur obtient une IP sur incusbr0 et démarre en quelques secondes. Vous êtes prêt pour les premiers pas.

À retenir

• Le dépôt Zabbly (pkgs.zabbly.com) fournit la dernière LTS (7.0), avec une clé de signature à vérifier.
• Le paquet natif (Debian 13, Ubuntu 24.04) est plus simple mais figé sur une version plus ancienne.
• incus admin init --auto crée un pool dir et le réseau incusbr0 ; sans --auto, un assistant permet de choisir ZFS/btrfs.
• Le groupe incus-admin donne l'accès sans sudo (équivalent à un accès root sur l'hôte).
• Testez avec incus launch images:debian/13.

FAQ : questions fréquentes sur l'installation d'Incus

Comment installer Incus sur Debian ou Ubuntu ?

Deux voies. Le dépôt Zabbly signé donne la dernière LTS : on ajoute la clé dans /etc/apt/keyrings, on déclare le dépôt lts-7.0 puis apt install incus. Ou le paquet natif depuis Debian 13 et Ubuntu 24.04 avec apt install incus, plus simple mais figé sur une version plus ancienne.

Quelle différence entre le dépôt Zabbly et le paquet natif d'Incus ?

Le dépôt Zabbly, maintenu par le créateur d'Incus, fournit la dernière version LTS et les feature releases, mises à jour rapidement.

Faut-il lancer incus admin init après l'installation ?

Oui. Tant que le démon n'est pas initialisé, Incus ne peut rien lancer. incus admin init crée un pool de stockage et un réseau.

Comment utiliser Incus sans sudo ?

On ajoute son utilisateur au groupe incus-admin avec usermod -aG incus-admin, puis on rouvre une session (ou newgrp incus-admin). Attention : appartenir à ce groupe donne un contrôle total sur Incus, donc indirectement un accès root sur l'hôte. À réserver aux utilisateurs de confiance.

Incus 7.0 LTS ou 6.0 LTS : laquelle choisir ?

La 7.0 LTS, sortie en mai 2026, est la version recommandée en production pour les nouvelles installations. La 6.0 LTS reste supportée jusqu'en 2029 et convient si votre distribution la fige. Les feature releases (7.1, 7.2...) ne sont supportées que jusqu'à la suivante : à éviter en production.

Prochaines étapes

Incus, c'est quoi ? Le gestionnaire de conteneurs système et de VMs.

Gérer ses instances Incus Lancer, manipuler conteneurs et machines virtuelles.

Proxmox VE Une alternative orientée hyperviseur avec interface web.

×

📖 Voir la documentation →