LazyDocker : gérez vos conteneurs Docker depuis le terminal

LazyDocker est une interface terminal (TUI) qui permet de gérer vos conteneurs, images, volumes et réseaux Docker sans mémoriser les commandes CLI. Un simple lazydocker affiche tout l'état de votre environnement Docker et permet d'agir en quelques touches. Projet open source de Jesse Duffield (créateur de Lazygit), il supporte Docker et Docker Compose.

Ce que vous allez apprendre

• Installer LazyDocker (v0.25.2) sur Linux, macOS ou Windows
• Naviguer dans l'interface avec les raccourcis clavier
• Gérer conteneurs, images, volumes et réseaux
• Personnaliser la configuration et ajouter vos propres commandes

Installation de LazyDocker

LazyDocker est un binaire Go statique sans dépendance : l'installation se résume à placer un fichier dans votre PATH. Une seule exigence côté système, un accès au socket Docker, puisque l'outil parle à l'API du démon local et n'embarque aucun moteur. Choisissez l'onglet de votre plateforme ; les deux méthodes proposées pour Linux et macOS diffèrent sur un point qui compte, le gestionnaire de versions vous permet de revenir en arrière, le téléchargement direct impose de refaire la manipulation à chaque bump.

Linux

Avec asdf-vm :

asdf plugin add lazydocker https://github.com/comdotlinux/asdf-lazydocker.git
asdf install lazydocker 0.25.2
asdf set --home lazydocker 0.25.2

Ou téléchargement direct, avec vérification de l'empreinte publiée par le projet. Le fichier checksums.txt accompagne chaque release et couvre tous les binaires :

VERSION="0.25.2"
BASE="https://github.com/jesseduffield/lazydocker/releases/download/v${VERSION}"
curl -sSLO "${BASE}/lazydocker_${VERSION}_Linux_x86_64.tar.gz"
curl -sSLO "${BASE}/checksums.txt"
sha256sum --check --ignore-missing checksums.txt
tar xzf "lazydocker_${VERSION}_Linux_x86_64.tar.gz" lazydocker
sudo install -m 0755 lazydocker /usr/local/bin/lazydocker

Sortie attendue

lazydocker_0.25.2_Linux_x86_64.tar.gz: OK

Si sha256sum affiche FAILED, l'archive est corrompue ou altérée : arrêtez là et ne l'extrayez pas.

macOS

Avec Homebrew :

brew install lazydocker

Ou téléchargement direct (Apple Silicon), avec la même vérification d'empreinte. shasum -a 256 remplace sha256sum, absent de macOS :

VERSION="0.25.2"
BASE="https://github.com/jesseduffield/lazydocker/releases/download/v${VERSION}"
curl -sSLO "${BASE}/lazydocker_${VERSION}_Darwin_arm64.tar.gz"
curl -sSLO "${BASE}/checksums.txt"
grep "Darwin_arm64" checksums.txt | shasum -a 256 --check
tar xzf "lazydocker_${VERSION}_Darwin_arm64.tar.gz" lazydocker
sudo install -m 0755 lazydocker /usr/local/bin/lazydocker

Windows

Avec Scoop :

scoop bucket add extras
scoop install lazydocker

Avec Chocolatey :

choco install lazydocker

Vérifiez l'installation :

lazydocker --version

Sortie attendue

Version: 0.25.2
Date: 2026-04-19T02:51:21Z
BuildSource: binaryRelease
Commit: 7e7aadc2071d58031bf2daafca1fbd4093efc23f
OS: linux
Arch: amd64

La ligne BuildSource mérite un coup d'œil : binaryRelease confirme que vous utilisez un binaire officiel. Une valeur unknown signale un binaire compilé localement ou repackagé par une distribution, dont le comportement peut différer.

Évolutions récentes

La version 0.24 a introduit la navigation par numéros entre panneaux et docker compose (sans tiret) comme commande par défaut. La version 0.25 améliore la prise en charge des projets Compose : les panneaux Project et Services sont masqués hors d'un projet Compose, et l'option -p permet de préciser le nom du projet.

Premier lancement

Lancez simplement :

lazydocker

L'interface affiche plusieurs panneaux :

Panneau	Contenu	Raccourci
Project	Services Docker Compose	1
Containers	Conteneurs en cours	2
Images	Images locales	3
Volumes	Volumes Docker	4
Networks	Réseaux Docker	5

Glissez pour voir

Navigation par numéros

Depuis v0.24.2, appuyez sur 1 à 5 pour sauter directement au panneau correspondant, comme dans Lazygit.

Raccourcis essentiels

Sept touches suffisent pour tout faire, et deux méritent d'être mémorisées en priorité. La touche x ouvre le menu d'actions du panneau où vous êtes : c'est le point d'entrée universel quand vous ne savez plus quelle touche utiliser. Les crochets [ et ] changent d'onglet dans le panneau de droite, ce qui n'est indiqué nulle part à l'écran et reste le raccourci le plus oublié.

Touche	Action
Tab / ← →	Changer de panneau
↑ ↓ / j k	Naviguer dans la liste
Enter	Voir les détails
x	Menu d'actions
[ ]	Changer d'onglet (Logs, Stats, Config)
/	Filtrer
q	Quitter

Glissez pour voir

Interface et navigation

Dans le panneau de droite, plusieurs onglets affichent des informations différentes :

Onglet	Description
Logs	Logs en temps réel du conteneur sélectionné
Stats	CPU, mémoire, I/O réseau et disque
Config	Configuration complète au format YAML
Top	Processus en cours dans le conteneur

Glissez pour voir

Actions sur les conteneurs

Sélectionnez un conteneur et appuyez sur x pour voir le menu :

Action	Touche	Commande équivalente
Arrêter	s	docker stop
Redémarrer	r	docker restart
Supprimer	d	docker rm
Attacher	a	docker attach
Shell	E	docker exec -it ... /bin/sh
Logs	l	docker logs -f

Glissez pour voir

Actions sur les images

Le panneau Images propose moins d'actions, mais la première sert au quotidien pour récupérer de l'espace disque. La colonne « Commande équivalente » vous permet de reproduire le geste dans un script. Notez la casse : P en majuscule pour pousser une image, alors que la plupart des autres raccourcis sont en minuscules ; c'est un garde-fou délibéré sur une action qui écrit dans un registre distant.

Action	Touche	Commande équivalente
Supprimer	d	docker rmi
Créer conteneur	c	docker run
Pusher	P	docker push

Glissez pour voir

Gérer les réseaux Docker

Depuis la version 0.21, LazyDocker affiche un panneau Networks dédié.

Appuyez sur 5 pour accéder aux réseaux, puis :

Action	Touche	Description
Inspecter	Enter	Voir la configuration réseau
Supprimer	d	Supprimer le réseau

Glissez pour voir

Le panneau affiche les réseaux bridge, host, none et personnalisés.

Personnaliser la configuration

LazyDocker stocke sa configuration dans :

OS	Chemin
Linux	~/.config/lazydocker/config.yml
macOS	~/Library/Application Support/jesseduffield/lazydocker/config.yml
Windows	C:\Users\<User>\AppData\Roaming\lazydocker\config.yml

Glissez pour voir

Édition avec VS Code

Installez l'extension YAML de Red Hat pour bénéficier de l'autocomplétion et la validation du schéma.

Options utiles

Vous n'avez pas besoin de recopier tout ce bloc : le fichier de configuration est partiel, seules les clés que vous écrivez surchargent les valeurs par défaut. Pour partir de l'existant plutôt que de deviner les noms de clés, la commande lazydocker -c affiche la configuration par défaut complète, valeurs comprises. Les trois options qui changent le plus le confort d'usage sont logs.since, qui borne la quantité de logs chargés au démarrage, logs.tail, qui limite le nombre de lignes affichées, et language, dont les codes acceptés sont auto, en, fr, de, es, pt, pl, nl, tr et zh.

config.yml

gui:
  # Langue : auto, en, fr, de, es, pt, pl, nl, tr, zh
  language: 'fr'
  # Mode d'affichage au démarrage : normal, half, fullscreen
  screenMode: "normal"
  # Style de statut : long, short, icon
  containerStatusHealthStyle: "short"
  # Style des bordures : single, double, rounded, hidden
  border: "rounded"
  theme:
    activeBorderColor:
      - green
      - bold
    selectedLineBgColor:
      - blue

logs:
  # Afficher les timestamps
  timestamps: true
  # Logs depuis X minutes ('' = tous)
  since: '60m'
  # Nombre de lignes à afficher
  tail: '200'

commandTemplates:
  # Utiliser docker compose (sans tiret) depuis v0.24
  dockerCompose: docker compose

Commandes personnalisées

Ajoutez vos propres commandes dans config.yml :

config.yml

customCommands:
  containers:
    - name: bash
      attach: true
      command: 'docker exec -it {{ .Container.ID }} bash'
      serviceNames: []
    - name: "Voir les variables d'environnement"
      attach: false
      command: 'docker exec {{ .Container.ID }} env'
      serviceNames: []
  images:
    - name: "Historique des layers"
      command: 'docker history {{ .Image.ID }}'
      attach: false

Variables disponibles

Ces variables sont des templates Go interpolés au moment où vous déclenchez la commande, avec l'élément actuellement sélectionné dans le panneau. Elles ne sont donc pas interchangeables : {{ .Container.ID }} n'a de sens que dans un bloc containers, et {{ .Service.Name }} que sous services. Une variable utilisée dans le mauvais bloc produit une chaîne vide, et la commande échoue avec un message qui ne pointe pas vers la vraie cause.

Variable	Description
{{ .Container.ID }}	ID du conteneur sélectionné
{{ .Container.Name }}	Nom du conteneur
{{ .Image.ID }}	ID de l'image
{{ .Service.Name }}	Nom du service Compose
{{ .DockerCompose }}	Commande docker compose

Glissez pour voir

Utiliser avec Docker Compose

Si vous êtes dans un dossier avec un docker-compose.yml, LazyDocker détecte automatiquement les services :

cd mon-projet/
lazydocker

Le panneau Project affiche alors tous les services définis.

Vous pouvez aussi spécifier un fichier Compose, ou nommer explicitement le projet avec -p lorsque le nom déduit du dossier ne correspond pas à celui utilisé par vos conteneurs :

lazydocker -f docker-compose.prod.yml
lazydocker -p mon-projet

Limitation en conteneur

Si vous exécutez LazyDocker dans un conteneur Docker, les logs et stats CPU ne s'affichent pas correctement. Préférez l'installation native.

Dépannage

La grande majorité des problèmes rencontrés avec LazyDocker viennent du démon Docker, pas de l'outil : il ne fait que lire l'API locale et affiche ce qu'elle lui renvoie. Le réflexe de diagnostic est donc de vérifier d'abord que docker ps fonctionne dans le même terminal, avec le même utilisateur. Si cette commande échoue, aucun réglage de LazyDocker n'y changera quoi que ce soit.

Problème	Cause	Solution
LazyDocker ne détecte pas Compose	Ancien format	Renommez docker-compose.yaml en docker-compose.yml
Pas de logs affichés	Conteneur sans stdout	Vérifiez que l'app écrit sur stdout
Erreur "Cannot connect to Docker"	Socket inaccessible	Vérifiez DOCKER_HOST ou ajoutez votre user au groupe docker
Stats à 0%	Conteneur arrêté	Démarrez le conteneur

Glissez pour voir

À retenir

• LazyDocker est une TUI pour gérer Docker sans mémoriser les commandes
• Navigation par numéros (1-5) pour sauter entre panneaux
• Onglets Logs, Stats, Config, Top pour chaque conteneur
• Panneau Networks pour gérer les réseaux Docker (v0.21+)
• Commandes personnalisées via customCommands dans config.yml
• Supporte docker compose (sans tiret) par défaut depuis v0.24
• Vérifiez toujours l'archive téléchargée avec le checksums.txt de la release avant d'installer le binaire

Prochaines étapes

Dozzle Le même besoin dans le navigateur : logs Docker en temps réel

Portainer CE Interface web complète pour Docker

Docker Compose Orchestrer plusieurs conteneurs

Crane Manipuler les images sans Docker

Dive Analyser les layers d'images

Plus d'infos

• GitHub LazyDocker
• Documentation configuration

Questions fréquentes

Quelle est la différence entre LazyDocker et Portainer ?

LazyDocker est une TUI terminal légère pour gérer Docker localement. Portainer est une interface web complète avec gestion multi-hôtes, RBAC et registries. LazyDocker pour le dev local, Portainer pour la production.

Comment installer LazyDocker sur Linux ?

Trois méthodes : asdf-vm (asdf install lazydocker 0.25.2), binaire GitHub vérifié avec le checksums.txt de la release, ou gestionnaire de paquets (brew, scoop). Version actuelle : 0.25.2.

Quels sont les raccourcis clavier essentiels de LazyDocker ?

Navigation : Tab ou flèches pour changer de panneau, 1-5 pour accès direct. Actions : x pour menu, Enter pour détails, q pour quitter. Onglets : [ et ] pour Logs/Stats/Config.

Comment voir les logs d'un conteneur dans LazyDocker ?

Sélectionnez le conteneur dans le panneau Containers (touche 2), les logs s'affichent automatiquement dans le panneau droit. Utilisez [ et ] pour naviguer entre Logs, Stats, Config.

Comment ajouter des commandes personnalisées dans LazyDocker ?

Éditez config.yml et ajoutez une section customCommands avec containers, images ou services. Utilisez les variables Go comme {{ .Container.ID }} dans vos commandes.

LazyDocker fonctionne-t-il avec Docker Compose ?

Oui, LazyDocker détecte automatiquement docker-compose.yml dans le dossier courant et affiche les services dans le panneau Project. Option -f pour spécifier un fichier Compose.

Où se trouve le fichier de configuration de LazyDocker ?

Linux : ~/.config/lazydocker/config.yml. macOS : ~/Library/Application Support/jesseduffield/lazydocker/config.yml. Windows : AppData/Roaming/lazydocker/config.yml.

Comment gérer les réseaux Docker avec LazyDocker ?

Depuis v0.21, appuyez sur 5 pour accéder au panneau Networks. Vous pouvez inspecter (Enter) ou supprimer (d) les réseaux bridge, host et personnalisés.

Pourquoi LazyDocker n'affiche pas les logs ou stats CPU ?

Trois causes possibles : conteneur arrêté, exécution dans un conteneur Docker (bug connu), ou socket Docker inaccessible. Vérifiez DOCKER_HOST et les permissions du groupe docker.

Quelles sont les nouveautés de LazyDocker v0.24 et v0.25 ?

La v0.24 apporte la navigation par numéros (1-5) entre panneaux et docker compose sans tiret par défaut. La v0.25 améliore la prise en charge des projets Compose et ajoute l'option -p pour nommer le projet.

×

📖 Voir la documentation →