Premiers pas avec Incus : lancer conteneurs et VMs

Une fois Incus installé, tout passe par une CLI cohérente : incus launch crée une instance, incus exec y exécute des commandes, incus snapshot la sauvegarde. Ce guide déroule les gestes essentiels sur des exemples réels : lancer un conteneur, lancer une machine virtuelle, entrer dedans, prendre un snapshot, ajuster la config, et gérer le cycle de vie. Tout a été testé sur Incus 7.0. Pour qui découvre Incus après l'installation.

Ce que vous allez apprendre

• Lancer un conteneur et une machine virtuelle (incus launch).
• Exécuter des commandes et ouvrir un shell (incus exec).
• Lister et inspecter les instances (incus list, incus info).
• Prendre et restaurer un snapshot.
• Gérer le cycle de vie (start, stop, delete).

Lancer son premier conteneur

La commande clé est incus launch <image> <nom>. Les images viennent par défaut du remote images:, le serveur d'images officiel.

incus launch images:debian/13 c1

En quelques secondes, le conteneur démarre et obtient une IP sur incusbr0 :

incus list

+------+---------+-----------------------+-----------+
| NAME |  STATE  |         IPV4          |   TYPE    |
+------+---------+-----------------------+-----------+
| c1   | RUNNING | 10.173.191.191 (eth0) | CONTAINER |
+------+---------+-----------------------+-----------+

launch vs init

incus launch crée et démarre l'instance. incus init la crée sans la démarrer, pratique pour la configurer avant le premier boot (incus start ensuite).

Entrer dans l'instance

Pour exécuter une commande à l'intérieur, utilisez incus exec <nom> -- <commande> :

incus exec c1 -- cat /etc/os-release
# PRETTY_NAME="Debian GNU/Linux 13 (trixie)"

Pour un shell interactif, incus shell (ou incus exec c1 -- bash) :

incus shell c1

C'est toute la différence avec Docker : un conteneur Incus est un système complet (avec systemd, des services, des utilisateurs), pas un processus unique. On s'y connecte comme à une petite machine.

Le conteneur a une IP mais pas d'Internet ?

Si une instance obtient bien une IP sur incusbr0 mais n'a ni DNS ni accès Internet, le coupable est presque toujours Docker installé sur le même hôte : son démon force une règle iptables FORWARD DROP qui jette le trafic d'Incus. Le contournement (règles DOCKER-USER) est détaillé dans le comparatif Incus vs Docker. Un pare-feu (firewalld/ufw) trop strict produit le même symptôme.

Inspecter une instance

incus list donne la vue d'ensemble ; incus info détaille une instance (état, type, ressources, réseau) :

incus info c1
# Name: c1
# Status: RUNNING
# Type: container
# Architecture: x86_64

Pour voir les images en cache local :

incus image list

Lancer une machine virtuelle

Le même launch crée une VM complète avec l'option --vm (QEMU) au lieu d'un conteneur :

incus launch images:ubuntu/24.04 vm1 --vm

+------+---------+-------------------------+-----------------+
| NAME |  STATE  |          IPV4           |      TYPE       |
+------+---------+-------------------------+-----------------+
| vm1  | RUNNING | 10.173.191.248 (enp5s0) | VIRTUAL-MACHINE |
+------+---------+-------------------------+-----------------+

Mêmes commandes, deux technologies : incus exec vm1 -- ... fonctionne dans la VM comme dans le conteneur, grâce à l'agent intégré.

VMs et virtualisation matérielle

Les VMs Incus s'appuient sur KVM : la machine hôte doit exposer la virtualisation matérielle (VT-x/AMD-V). Si Incus tourne lui-même dans une VM, activez le nested-virt sur l'hyperviseur.

Prendre un snapshot

Avant une manipulation risquée, incus snapshot create fige l'état de l'instance :

incus snapshot create c1 snap0
incus snapshot list c1

+-------+----------------------+------------+----------+
| NAME  |       TAKEN AT       | EXPIRES AT | STATEFUL |
+-------+----------------------+------------+----------+
| snap0 | 2026/06/30 20:59 UTC |            | NO       |
+-------+----------------------+------------+----------+

En cas de souci, on restaure avec incus snapshot restore c1 snap0. Le snapshot capture le disque ; ajoutez --stateful pour aussi figer la mémoire d'une instance en marche.

Ajuster la configuration

Les ressources se règlent à chaud avec incus config set :

incus config set c1 limits.memory=512MiB
incus config get c1 limits.memory
# 512MiB

On limite de même le CPU (limits.cpu=2), on ajoute des devices (disque, carte réseau, port forwarding), on active le démarrage auto (boot.autostart=true).

Gérer le cycle de vie

incus stop c1            # arrêter
incus start c1           # démarrer
incus restart c1         # redémarrer
incus delete c1          # supprimer (instance arrêtée)
incus delete c1 --force  # forcer la suppression d'une instance en marche

Une instance supprimée l'est définitivement (avec ses snapshots) : pensez à exporter ou à sauvegarder ce qui compte avant.

À retenir

• incus launch images:<distro> <nom> crée et démarre une instance depuis le remote images:.
• Ajoutez --vm pour une machine virtuelle au lieu d'un conteneur ; les mêmes commandes s'appliquent.
• incus exec lance une commande, incus shell ouvre un shell : un conteneur Incus est un système complet.
• incus snapshot create sauvegarde l'état ; restaurez avec snapshot restore.
• incus config set règle mémoire, CPU et devices à chaud.

FAQ : questions fréquentes sur les premiers pas avec Incus

Comment lancer un conteneur avec Incus ?

Avec incus launch suivi de l'image et d'un nom, par exemple incus launch images:debian/13 c1. L'image provient du remote images: par défaut. Le conteneur démarre en quelques secondes et obtient une IP sur le réseau incusbr0. On le vérifie avec incus list.

Quelle différence entre incus launch et incus init ?

incus launch crée et démarre l'instance en une commande. incus init la crée sans la démarrer, ce qui permet de modifier sa configuration (CPU, mémoire, devices) avant le premier démarrage, puis de lancer incus start. launch est le raccourci le plus courant pour démarrer vite.

Comment entrer dans un conteneur Incus ?

Avec incus exec pour lancer une commande, par exemple incus exec c1 -- cat /etc/os-release, ou incus shell c1 pour ouvrir un shell interactif.

Comment lancer une machine virtuelle avec Incus ?

Avec la même commande incus launch et l'option --vm, par exemple incus launch images:ubuntu/24.04 vm1 --vm. Incus crée alors une VM QEMU complète au lieu d'un conteneur. Les mêmes commandes (exec, info, snapshot) fonctionnent grâce à l'agent intégré. La virtualisation matérielle KVM est requise.

Comment prendre un snapshot avec Incus ?

Avec incus snapshot create suivi du nom de l'instance et du snapshot, par exemple incus snapshot create c1 snap0. On liste avec incus snapshot list et on restaure avec incus snapshot restore c1 snap0. L'option --stateful fige aussi la mémoire d'une instance en marche, pas seulement le disque.

Prochaines étapes

Installer Incus Le guide d'installation, si ce n'est pas déjà fait.

Gérer ses instances Aller plus loin avec conteneurs et VMs.

Incus, c'est quoi ? Comprendre la place d'Incus face à Docker et Proxmox.

×

📖 Voir la documentation →