Installer Podman : Ubuntu/Debian, Fedora, macOS, Windows (WSL2/Hyper-V)

Versions référence

Deux branches sont maintenues en parallèle, et elles ont été publiées le même jour, le 16 septembre 2026 : la 6.1.2, branche courante, et la 5.8.7, dernière 5.x. Ce guide couvre les deux, parce que les distributions ne suivent pas au même rythme : Debian 13 livre encore la 5.4. Ce qui change d'une branche à l'autre est décrit dans les nouveautés Podman 6.

Ce guide vous permet d'installer Podman sur votre système en mode rootless (sans droits root). Que vous soyez sur Linux, macOS ou Windows, vous aurez un environnement de conteneurs fonctionnel et sécurisé. À la fin, vous saurez :

• Installer Podman sur votre distribution Linux
• Configurer le mode rootless (exécution sans droits root)
• Utiliser Podman Machine sur macOS et Windows
• Vérifier que tout fonctionne avec un conteneur de test

Prérequis

Plateforme	Prérequis
Linux	Compte utilisateur standard, accès sudo pour l'installation
macOS	macOS 13+ (Ventura), Homebrew installé
Windows	Windows 10/11, WSL 2 activé ou Hyper-V disponible

Glissez pour voir

Quel guide lire avant ?

Si vous débutez avec Podman, lisez d'abord le guide Concepts Podman pour comprendre les notions de daemonless et rootless.

Qu'est-ce que le mode rootless ?

Avant d'installer, comprenons pourquoi le mode rootless est important.

Par défaut, Podman s'exécute sans droits root (administrateur). Les conteneurs tournent donc avec les permissions de votre compte, pas avec celles de l'administrateur système : un conteneur compromis n'obtient rien de plus que ce que vous pouvez déjà faire.

Pourquoi c'est mieux ?

Aspect	Mode root (traditionnel)	Mode rootless (Podman par défaut)
Sécurité	Un conteneur compromis peut affecter tout le système	Un conteneur compromis n'a que vos droits utilisateur
Installation	Nécessite des droits admin	Fonctionne avec un compte standard
Partage de machine	Conflits possibles entre utilisateurs	Chaque utilisateur a ses propres conteneurs

Glissez pour voir

Et Docker ?

Docker propose aussi un mode rootless, depuis la version 20.10, mais il n'est pas activé par défaut et réclame une installation séparée. Podman est conçu rootless dès le départ.

Choisir sa méthode d'installation

Avant de vous lancer, identifiez la méthode adaptée à votre situation :

Fedora / RHEL / CentOS Dépôts natifs dnf, versions toujours à jour

Ubuntu / Debian Dépôts apt natifs ; Homebrew sur Linux pour une version plus récente

Arch Linux / openSUSE Dépôts officiels, généralement à jour

macOS Homebrew + Podman Machine (VM obligatoire)

Windows Winget/MSI + Podman Machine avec WSL2 ou Hyper-V

WSL2 vs Hyper-V sur Windows

WSL2 est recommandé pour le développement quotidien (performances, intégration). Hyper-V offre une isolation plus forte pour les environnements de production ou de test sécurisé.

Installation sur Linux

Fedora / RHEL

Fedora et RHEL ont Podman nativement, c'est la meilleure expérience car les versions sont toujours à jour.

1. Installer Podman

   sudo dnf install -y podman

2. Vérifier la version

   podman version

   Sortie attendue (les numéros varient selon la distro) :

   Client:       Podman Engine
   Version:      5.x.x
   API Version:  5.x.x
   Go Version:   go1.22.x
   OS/Arch:      linux/amd64

3. Tester avec un conteneur

   podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo "Hello Podman!"

   Sortie attendue :

   Hello Podman!

Fedora Silverblue / CoreOS

Sur les systèmes immuables (Silverblue, CoreOS), Podman est préinstallé. Pas besoin d'installer quoi que ce soit !

Ubuntu / Debian

Sur Ubuntu et Debian, Podman est disponible dans les dépôts natifs. Depuis Debian 13 (trixie) et Ubuntu 25.10, la version fournie est récente ; les versions LTS plus anciennes en embarquent une plus ancienne.

sudo apt update
sudo apt install -y podman
podman --version

Distribution	Version Podman fournie
Debian 13, Ubuntu 25.10	5.4
Ubuntu 24.04 LTS	4.9
Debian 12	4.3

Glissez pour voir

Le dépôt Kubic libcontainers est fermé

L'ancien dépôt OBS devel:kubic:libcontainers, longtemps recommandé pour installer une version récente sur Ubuntu/Debian, a été arrêté et renvoie désormais des 404. N'y faites plus référence. Pour une version plus récente que celle de votre distribution : mettez à jour la distribution, utilisez Homebrew sur Linux (brew install podman, qui suit la branche courante, 6.1.x), ou passez par un conteneur outil (toolbox, distrobox).

Validez ensuite l'installation avec un conteneur de test :

podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo "Hello Podman!"

Arch Linux

Arch Linux propose toujours les dernières versions dans ses dépôts officiels.

1. Installer Podman

   sudo pacman -S podman

2. Installer les outils complémentaires (optionnel mais recommandé)

   sudo pacman -S buildah skopeo podman-compose

3. Vérifier l'installation

   podman version
   podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo "Hello Podman!"

openSUSE

openSUSE, comme Fedora, est une distribution proche de Red Hat avec un excellent support Podman.

1. Installer Podman

   sudo zypper install podman

2. Vérifier l'installation

   podman version

3. Tester

   podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo "Hello Podman!"

Configuration du mode rootless sur Linux

Après l'installation, vous devez configurer le mode rootless pour profiter de la sécurité maximale.

Vérifier la configuration subuid/subgid

Le mode rootless utilise les user namespaces de Linux. Pour que ça fonctionne, votre utilisateur doit avoir des plages d'UID/GID allouées.

Sur une distribution récente, vous n'aurez probablement rien à faire : les plages sont posées à la création du compte. Vérifié sur Debian 13, juste après apt install podman et sans aucune commande supplémentaire, le compte portait déjà ansible:165536:65536 dans les deux fichiers. Les étapes qui suivent servent alors de contrôle, et ne deviennent une vraie manipulation que sur un système plus ancien ou un compte créé à la main.

1. Vérifier que les fichiers existent et contiennent votre utilisateur

   grep $USER /etc/subuid /etc/subgid

   Sortie attendue (avec votre nom d'utilisateur) :

   /etc/subuid:bob:100000:65536
   /etc/subgid:bob:100000:65536

   Cela signifie que l'utilisateur bob peut utiliser 65536 UIDs à partir de 100000.

2. Si les lignes n'existent pas, ajoutez-les :

   sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 $USER

3. Initialiser le namespace utilisateur

   podman system migrate

Pourquoi subuid/subgid ?

Les user namespaces permettent de projeter les UIDs du conteneur vers des UIDs différents sur l'hôte. Le root du conteneur, UID 0, devient ainsi un utilisateur non privilégié sur l'hôte, quelque part au-dessus de 100000. C'est toute la clé de la sécurité rootless.

Vérifier que le mode rootless est actif

podman info --format '{{.Host.Security.Rootless}}'

Sortie attendue :

true

Où sont stockées les images en rootless ?

Contrairement à Docker qui stocke tout dans /var/lib/docker/ (accessible uniquement par root), Podman rootless utilise votre dossier personnel :

podman info --format '{{.Store.GraphRoot}}'

Sortie :

/home/bob/.local/share/containers/storage

Cela signifie que chaque utilisateur a son propre espace de stockage d'images, totalement isolé.

Installation sur macOS

macOS ne peut pas exécuter de conteneurs Linux nativement (le noyau est différent). Podman utilise donc une machine virtuelle Linux légère appelée Podman Machine.

Installer Podman via Homebrew

1. Installer Homebrew si ce n'est pas déjà fait

   La page d'installation officielle propose un curl directement branché sur un interpréteur. Ce guide ne le reproduit pas, pour deux raisons : cette forme exécute un script avant que vous l'ayez lu, et une interruption réseau en cours de téléchargement peut faire exécuter un fichier tronqué. Téléchargez d'abord, relisez, exécutez ensuite :

   curl -fsSL -o /tmp/homebrew-install.sh \
     https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
   less /tmp/homebrew-install.sh          # lecture avant exécution
   /bin/bash /tmp/homebrew-install.sh

   Le principe vaut bien au-delà de Homebrew : tout installateur distribué par script distant se télécharge, se relit, puis s'exécute.

2. Installer Podman

   brew install podman

3. Créer et démarrer la machine virtuelle

   podman machine init
   podman machine start

   La première exécution télécharge une image Linux (~300 Mo) et crée la VM.

4. Vérifier que tout fonctionne

   podman version
   podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo "Hello Podman on macOS!"

Options de Podman Machine

Vous pouvez personnaliser les ressources de la VM lors de la création :

# Machine avec 4 CPUs, 4 Go de RAM, 50 Go de disque
podman machine init --cpus 4 --memory 4096 --disk-size 50

# Démarrer
podman machine start

Provider : Apple Virtualization vs QEMU

Sur macOS récent, Podman peut utiliser Apple Virtualization Framework (plus performant) ou QEMU. Le framework Apple est sélectionné par défaut sur les Mac compatibles.

Commandes utiles Podman Machine

Commande	Description
podman machine list	Lister les machines
podman machine start	Démarrer la machine par défaut
podman machine stop	Arrêter la machine
podman machine ssh	Se connecter en SSH à la VM
podman machine rm	Supprimer une machine
podman machine inspect	Détails de configuration

Glissez pour voir

Installation sur Windows

Windows, comme macOS, nécessite une machine virtuelle pour exécuter les conteneurs Linux.

WSL 2 (recommandé)

WSL 2 (Windows Subsystem for Linux) offre les meilleures performances.

1. Activer WSL 2 (si pas déjà fait)

   Ouvrez PowerShell en tant qu'administrateur :

   wsl --install

   Redémarrez si demandé.

2. Installer Podman via winget

   winget install RedHat.Podman

   Ou téléchargez l'installateur MSI depuis github.com/containers/podman/releases.

3. Créer la machine Podman

   Ouvrez un terminal (PowerShell ou CMD) :

   podman machine init
   podman machine start

4. Tester

   podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo "Hello Podman on Windows!"

Hyper-V

Si vous ne pouvez pas utiliser WSL 2, Hyper-V est une alternative.

1. Activer Hyper-V

   Panneau de configuration → Programmes → Activer ou désactiver des fonctionnalités Windows → Hyper-V

   Ou via PowerShell (admin) :

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

2. Installer Podman

   winget install RedHat.Podman

3. Créer la machine avec le provider HyperV

   podman machine init --provider hyperv
   podman machine start

Hyper-V vs WSL 2

Hyper-V offre une isolation plus forte mais consomme plus de ressources. WSL 2 est généralement préféré pour le développement quotidien.

Podman Desktop (interface graphique)

Si vous préférez une interface graphique, Podman Desktop est disponible sur toutes les plateformes.

Installation

Plateforme	Méthode recommandée	Alternative
macOS	Télécharger .dmg (recommandé)	brew install --cask podman-desktop
Windows	winget install RedHat.Podman-Desktop	Télécharger .exe
Linux	Flatpak : flatpak install flathub io.podman_desktop.PodmanDesktop	AppImage disponible

Glissez pour voir

Pourquoi .dmg sur macOS ?

L'installation via .dmg est recommandée par l'équipe Podman Desktop pour éviter des problèmes de chemins ou de stabilité parfois rencontrés avec Homebrew.

Fonctionnalités principales

• Gestion visuelle des conteneurs, images, pods
• Gestion des machines Podman (macOS/Windows)
• Intégration avec Kubernetes
• Extensions (Kind, OpenShift, etc.)

CLI vs GUI

Même si Podman Desktop est pratique pour visualiser, apprenez les commandes CLI, elles sont essentielles pour l'automatisation et les scripts.

Vérification de l'installation (toutes plateformes)

Quelle que soit votre plateforme, effectuez ces vérifications :

1. Version installée

   podman version

   Vérifiez que la version est au moins la 5.4. Les branches 5.8 et 6.1 sont les deux séries maintenues aujourd'hui.

2. Informations système

   podman info

   Points à vérifier :

   • host.security.rootless: true (Linux)
   • store.graphDriverName: overlay
   • host.ociRuntime.name: crun ou runc

3. Test d'exécution

   podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 cat /etc/os-release

   Sortie attendue :

   NAME="Alpine Linux"
   ID=alpine
   VERSION_ID=3.22.6
   PRETTY_NAME="Alpine Linux v3.22"
   ...

4. Test de pull depuis plusieurs registres

   Podman ne présume aucun registre par défaut, contrairement à Docker qui complète silencieusement en docker.io. Tirer une image depuis trois registres différents vérifie que la résolution de nom et le réseau fonctionnent partout, pas seulement sur Docker Hub.

   # Docker Hub
   podman pull docker.io/library/nginx:1.29.3-alpine@sha256:b3c656d55d7ad751196f21b7fd2e8d4da9cb430e32f646adcf92441b72f82b14
   
   # Quay.io (Red Hat)
   podman pull quay.io/podman/hello:latest@sha256:41316c18917a27a359ee3191fd8f43559d30592f82a144bbc59d9d44790f6e7a
   
   # GitHub Container Registry
   podman pull ghcr.io/astral-sh/uv:0.9.9@sha256:f6e3549ed287fee0ddde2460a2a74a2d74366f84b04aaa34c1f19fec40da8652

Dépannage

Erreurs courantes et solutions

Symptôme	Cause probable	Solution
ERRO[0000] cannot find UID/GID	subuid/subgid non configurés	sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 $USER
Error: rootless mode	Namespace utilisateur non initialisé	podman system migrate
machine not running (macOS/Windows)	Machine Podman arrêtée	podman machine start
Error: dial unix	Socket Podman inaccessible	Vérifier que le service fonctionne
permission denied sur les fichiers	Problème de mapping UID	Utiliser :U ou --userns=keep-id
no systemd user session available, puis Falling back to --cgroup-manager=cgroupfs	Session sans gestionnaire systemd utilisateur, typiquement une connexion SSH non interactive	sudo loginctl enable-linger $USER, puis rouvrir une session

Glissez pour voir

« no systemd user session available » : le conteneur tourne quand même

C'est le message qui inquiète le plus à la première utilisation, et ce n'est pas une erreur. Mesuré sur Debian 13 depuis une session SSH, le tout premier podman run affiche huit lignes d'avertissement avant la sortie attendue :

level=warning msg="The cgroupv2 manager is set to systemd but there is no systemd user session available"
level=warning msg="Alternatively, you can enable lingering with: `loginctl enable-linger 1001` (possibly as root)"
level=warning msg="Falling back to --cgroup-manager=cgroupfs"

Podman bascule sur cgroupfs et le conteneur s'exécute normalement : rien n'est cassé. Le remède est celui que le message indique lui-même, mais il porte un piège qu'il passe sous silence :

Moment	Lignes d'avertissement
Avant loginctl enable-linger	8
Après, dans la même session	8, inchangé
Dans la session suivante	0

Glissez pour voir

Le réglage ne prend pas effet dans la session où vous le posez. Rejouer la commande aussitôt donne l'impression qu'elle ne sert à rien : il faut se déconnecter et se reconnecter pour qu'un gestionnaire systemd utilisateur existe.

Permissions volumes : 2 recettes

En mode rootless, les problèmes de permissions sur les volumes montés sont la difficulté la plus fréquente : les UIDs du conteneur ne correspondent pas à ceux de l'hôte, et un fichier parfaitement lisible d'un côté ne l'est plus de l'autre.

Recette 1 : --userns=keep-id (aligner les UIDs)

Cette option fait correspondre votre UID réel avec l'UID dans le conteneur :

podman run --rm --userns=keep-id -v ./data:/data:rw docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 ls -la /data

→ Votre utilisateur (ex: UID 1000) sera aussi UID 1000 dans le conteneur.

Recette 2 : suffixe :U (chown automatique)

Le suffixe :U sur un volume indique à Podman de changer récursivement le propriétaire des fichiers pour correspondre à l'UID du conteneur :

podman run --rm -v ./data:/data:U docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 ls -la /data

Attention avec :U

Le suffixe :U modifie le propriétaire des fichiers sur l'hôte, et l'effet dépend de l'utilisateur du conteneur, ce qui en fait une option à manier avec méthode. Mesuré sur Debian 13, Podman 5.4.2, depuis un compte d'UID 1001 :

Conteneur lancé	UID du fichier sur l'hôte, après
en root (défaut)	1001, inchangé
avec --user 1000	166535

Glissez pour voir

Dans le premier cas rien ne bouge, parce que le root du conteneur est justement projeté sur votre propre UID. Dans le second, le fichier part dans votre plage subuid et devient illisible pour votre compte. C'est ce second cas qui justifie la prudence sur des données partagées.

Redémarrer proprement

Si quelque chose ne fonctionne pas :

# Linux
podman system reset

# macOS/Windows
podman machine stop
podman machine rm
podman machine init
podman machine start

podman system reset

Cette commande supprime tous vos conteneurs, images et volumes ! Utilisez-la uniquement pour repartir de zéro.

Checklist post-installation

Après installation, vérifiez que tout fonctionne avec cette checklist :

Vérification	Commande	Résultat attendu
Version	podman version	Version 5.4 ou supérieure
Runtime	podman info --format '{{.Host.OCIRuntime.Name}}'	crun ou runc
Storage driver	podman info --format '{{.Store.GraphDriverName}}'	overlay
Rootless (Linux)	podman info --format '{{.Host.Security.Rootless}}'	true
Test conteneur	podman run --rm docker.io/library/alpine:3.22@sha256:5291449c3df73caf6ed85e649dec1b9e818b39a5d8c871e97afc13e9cd5e8fa8 echo ok	ok
Machine (macOS/Win)	podman machine list	Une machine running
SSH machine	podman machine ssh uname -a	Infos Linux affichées

Glissez pour voir

À retenir

1. Podman est rootless par défaut, plus sécurisé, chaque utilisateur a ses propres conteneurs
2. Linux : installation native ; sur une distribution récente les plages /etc/subuid et /etc/subgid sont déjà posées, il suffit de les vérifier
3. macOS/Windows : utiliser Podman Machine qui crée une VM Linux légère
4. Ubuntu/Debian : les dépôts natifs peuvent être en retard, et l'ancien dépôt OBS libcontainers est fermé ; pour une version plus récente, changez de version de distribution ou passez par Homebrew sur Linux
5. Vérifier avec podman info que le mode rootless est actif et le runtime correct
6. Problèmes de permissions : utiliser --userns=keep-id ou le suffixe :U

Pour aller plus loin

• Options d'exécution avancées : Les options qui comptent une fois les premières commandes acquises.
• Volumes et données persistantes : Le premier sujet à traiter en rootless, où les permissions surprennent.
• Construire une image : Produire ses propres images sans démon ni privilège root.

×

📖 Voir la documentation →