tmux : Multiplexeur de terminal pour DevOps

Ce guide vous apprend à utiliser tmux pour ne plus jamais perdre votre travail en cas de déconnexion SSH. Vous saurez créer des sessions persistantes, organiser votre terminal en panneaux et onglets, et personnaliser tmux selon vos besoins. Prérequis : accès à un terminal Linux, macOS ou WSL.

Pourquoi utiliser tmux ?

Le problème que tmux résout

Imaginez cette situation : vous êtes connecté en SSH à un serveur de production. Vous lancez une migration de base de données qui prend 2 heures. Au bout d’une heure, votre connexion Wi-Fi coupe pendant 30 secondes.

Ce qui se passe sans tmux :

1. Votre connexion SSH est interrompue
2. Le terminal distant reçoit un signal “raccrocher” (SIGHUP)
3. Tous les processus lancés depuis ce terminal sont tués
4. Votre migration s’arrête à mi-chemin
5. Vous avez une base de données dans un état incohérent

C’est un vrai problème qui arrive régulièrement aux DevOps, sysadmins, et développeurs qui travaillent sur des serveurs distants.

Cela vous est déjà arrivé ?

• Compilation interrompue après 45 minutes
• Déploiement Ansible coupé en plein milieu
• Restauration de backup annulée
• Session de debug perdue avec tout le contexte

tmux existe précisément pour éviter ces frustrations.

Comment tmux résout ce problème

Pour comprendre tmux, faisons une analogie avec un bureau physique.

Sans tmux : vous travaillez sur un bureau qui disparaît dès que vous quittez la pièce. Tous vos documents, outils et travail en cours disparaissent avec.

Avec tmux : vous travaillez dans un bureau qui reste intact même quand vous partez. Quand vous revenez, tout est exactement comme vous l’avez laissé : les documents ouverts, les programmes en cours d’exécution, l’organisation de votre espace.

Explication technique simplifiée

Techniquement, tmux crée un serveur qui tourne en arrière-plan sur la machine. Ce serveur gère vos terminaux. Quand vous fermez votre connexion SSH, le serveur tmux continue de tourner. Vos processus sont rattachés au serveur tmux, pas à votre connexion SSH.

Ce que tmux apporte concrètement

Situation	Sans tmux	Avec tmux
Déconnexion accidentelle	Tout est perdu	On reprend où on en était
Tâche longue (compilation, backup)	Doit garder le terminal ouvert	Lance et reviens plus tard
Travailler sur plusieurs choses	Plusieurs terminaux à gérer	Un seul terminal, plusieurs espaces
Montrer son écran à un collègue	Partage d’écran Zoom/Teams	Session partagée en temps réel
Revenir le lendemain	Tout refaire depuis zéro	Session sauvegardée

Glissez pour voir

Qu’est-ce qu’un multiplexeur de terminal ?

Le nom “tmux” vient de Terminal MUltipleXer. Décomposons ce terme :

• Terminal : l’interface texte où vous tapez des commandes
• Multiplexer : combiner plusieurs signaux en un seul (terme d’électronique)

Un multiplexeur de terminal permet donc de combiner plusieurs terminaux virtuels dans une seule fenêtre de terminal physique.

Ce que “multiplexer” signifie concrètement

Imaginez que vous ayez un seul écran d’ordinateur, mais que vous puissiez y afficher 4 bureaux différents, tous actifs en même temps, et passer de l’un à l’autre instantanément. C’est exactement ce que fait tmux avec les terminaux.

Autres multiplexeurs

tmux n’est pas le seul multiplexeur de terminal. screen (plus ancien) et Zellij (plus moderne) font la même chose. tmux est le plus utilisé en DevOps car il est présent sur presque toutes les machines Linux et très bien documenté.

Les trois concepts fondamentaux de tmux

Avant de pratiquer, comprenons les trois niveaux d’organisation de tmux. C’est essentiel pour ne pas se perdre.

1. La session : votre espace de travail

Une session est un espace de travail complet et indépendant. Pensez-y comme à un projet ou un contexte de travail.

Exemple concret : vous pouvez avoir :

• Une session “api-backend” pour le développement de l’API
• Une session “monitoring” pour surveiller les serveurs
• Une session “database” pour les opérations de BDD

Chaque session est isolée des autres et persiste même quand vous êtes déconnecté.

Bonne pratique

Nommez toujours vos sessions avec des noms explicites. “travail” ou “dev” sont vagues. Préférez “api-v2”, “migration-users”, “debug-auth”.

2. La window : un onglet

Une window (fenêtre) est un onglet à l’intérieur d’une session. Comme les onglets dans votre navigateur web.

Exemple concret : dans votre session “api-backend”, vous pouvez avoir :

• Window 1 : “editeur” - où vous codez
• Window 2 : “serveur” - où tourne votre serveur de dev
• Window 3 : “tests” - où vous lancez les tests
• Window 4 : “git” - pour vos commits

Vous ne voyez qu’une seule window à la fois (comme un onglet), mais vous passez de l’une à l’autre instantanément.

3. Le pane : une subdivision d’écran

Un pane (panneau) est une division d’une window. Vous pouvez couper votre écran en 2, 4, 6… parties, chacune avec son propre terminal.

Exemple concret : dans votre window “debug”, vous pouvez avoir :

• Pane gauche : les logs du serveur
• Pane droite : vos commandes de test

Ainsi, vous voyez les logs en temps réel pendant que vous testez.

Schéma récapitulatif

Pourquoi ces trois niveaux ?

Cette organisation peut sembler complexe au début, mais elle reflète la façon dont on travaille réellement :

• Session = un projet ou un contexte (on peut en avoir plusieurs en parallèle)
• Window = une tâche dans ce projet (code, test, logs…)
• Pane = voir plusieurs choses en même temps pour une tâche donnée

Vous n’êtes pas obligé d’utiliser les trois. Beaucoup de gens n’utilisent que les sessions au début.

Installation

Version actuelle : 3.4 (2024)

tmux est disponible dans les dépôts de toutes les distributions Linux. L’installation prend quelques secondes.

Ubuntu/Debian

sudo apt update && sudo apt install -y tmux

Vérification :

tmux -V

Vous devez voir tmux 3.4 (ou une version proche).

Fedora/RHEL

sudo dnf install -y tmux
tmux -V

Arch Linux

sudo pacman -S tmux
tmux -V

macOS

Sur macOS, utilisez Homebrew :

brew install tmux
tmux -V

mise (recommandé)

mise permet de gérer les versions de vos outils :

mise install tmux@latest
mise use -g tmux@latest
tmux -V

Avantage : vous pouvez avoir plusieurs versions de tmux et les mettre à jour facilement.

tmux est déjà installé sur beaucoup de serveurs

Avant d’installer, vérifiez si tmux est déjà présent :

which tmux
tmux -V

Sur les serveurs de production, il est souvent déjà installé.

Votre première session tmux

Apprenons par la pratique. Nous allons créer une session, lancer une commande, nous détacher, et nous rattacher.

Comprendre le préfixe (très important)

Avant de commencer, une notion essentielle : le préfixe.

Quand vous êtes dans tmux, comment distinguer une commande pour tmux d’une commande normale ? Par exemple, si vous appuyez sur “d”, tmux doit comprendre :

• Est-ce que vous voulez taper la lettre “d” dans votre terminal ?
• Ou est-ce que vous voulez vous détacher de tmux ?

La solution : le préfixe. Par défaut, c’est Ctrl+B.

Comment ça marche :

1. Vous appuyez sur Ctrl et B en même temps
2. Vous relâchez
3. Vous appuyez sur la touche de commande (par exemple d pour détacher)

Notation

Dans ce guide et dans la documentation tmux, vous verrez souvent C-b d. Cela signifie :

• C-b = Ctrl+B (le préfixe)
• d = la touche de commande

Donc C-b d = appuyer sur Ctrl+B, relâcher, appuyer sur d.

Étape par étape : votre première session

1. Ouvrez un terminal

   Sur votre machine locale ou en SSH vers un serveur.

2. Créez une session nommée

   tmux new -s apprentissage

   Que se passe-t-il :

   • tmux démarre un serveur en arrière-plan (s’il n’existe pas déjà)
   • Il crée une session nommée “apprentissage”
   • Il vous connecte automatiquement à cette session

   Comment savoir que vous êtes dans tmux ?

   Regardez en bas de votre terminal : une barre verte (par défaut) est apparue. Elle affiche le nom de la session et la liste des windows.

3. Lancez une commande (simulation d’une tâche longue)

   # Cette commande affiche un compteur toutes les secondes
   for i in $(seq 1 1000); do echo "Compteur: $i"; sleep 1; done

   Vous voyez le compteur s’incrémenter. Laissez-le tourner.

4. Détachez-vous de la session

   Appuyez sur : Ctrl+B (relâchez), puis d

   Que se passe-t-il :

   • Vous revenez à votre terminal normal (sans la barre verte)
   • Le message [detached (from session apprentissage)] s’affiche
   • Mais le compteur continue de tourner en arrière-plan !

5. Vérifiez que la session existe encore

   tmux ls

   Résultat attendu :

   apprentissage: 1 windows (created Thu Feb  6 10:30:00 2026)

   La session existe toujours, avec 1 window.

6. Rattachez-vous à la session

   tmux attach -t apprentissage

   Que se passe-t-il :

   • Vous retournez dans tmux
   • Le compteur a continué pendant votre absence !
   • Si vous étiez à “Compteur: 10” quand vous êtes parti et que 30 secondes ont passé, vous êtes maintenant à “Compteur: 40”

7. Arrêtez le compteur et quittez

   • Ctrl+C pour arrêter le compteur
   • exit pour fermer la window (et donc la session, puisqu’il n’y en a qu’une)

Vous avez compris l'essentiel !

Avec juste ces commandes — tmux new -s nom, C-b d, tmux attach -t nom — vous pouvez déjà :

• Lancer des tâches longues et les laisser tourner
• Vous déconnecter sans tout perdre
• Revenir exactement où vous en étiez

C’est la fonction principale de tmux. Le reste (windows, panes, configuration) est du bonus pour être plus efficace.

Les commandes à connaître absolument

Les 5 commandes shell (hors tmux)

Ces commandes se tapent dans un terminal normal, avant d’entrer dans tmux :

Commande	Ce qu’elle fait	Quand l’utiliser
tmux new -s NOM	Crée une session nommée NOM	Démarrer un nouveau travail
tmux ls	Liste les sessions existantes	Voir ce qui tourne
tmux attach -t NOM	Se connecte à la session NOM	Reprendre un travail
tmux attach	Se connecte à la dernière session	Raccourci si une seule session
tmux kill-session -t NOM	Supprime la session NOM	Nettoyer (attention, tue les processus !)

Glissez pour voir

kill-session tue les processus

tmux kill-session ne détache pas seulement, il tue tous les processus de la session. Utilisez-le uniquement quand vous avez vraiment fini.

Les 10 raccourcis tmux (dans tmux)

Ces raccourcis s’utilisent depuis l’intérieur de tmux. Rappel : C-b signifie Ctrl+B (le préfixe).

Pour les sessions

Raccourci	Ce qu’il fait	Mnémotechnique
C-b d	Détache de la session	detach
C-b $	Renomme la session	$ = nom de variable, donc nom
C-b s	Liste les sessions (pour naviguer)	sessions

Glissez pour voir

Pour les windows (onglets)

Raccourci	Ce qu’il fait	Mnémotechnique
C-b c	Crée une nouvelle window	create
C-b n	Passe à la window suivante	next
C-b p	Passe à la window précédente	previous
C-b ,	Renomme la window actuelle	virgule = pause pour réfléchir au nom
C-b w	Liste les windows (pour naviguer)	windows

Glissez pour voir

Pour les panes (divisions)

Raccourci	Ce qu’il fait	Mnémotechnique
C-b "	Divise horizontalement (haut/bas)	” ressemble à deux traits horizontaux
C-b %	Divise verticalement (gauche/droite)	% ressemble à une division
C-b flèches	Navigue entre les panes	intuitif
C-b x	Ferme le pane actuel	x = croix = fermer
C-b z	Zoom/dézoom le pane (plein écran)	zoom

Glissez pour voir

Vous n'avez pas besoin de tout retenir

Retenez ces trois essentiels pour commencer :

• C-b d pour détacher
• C-b c pour créer une window
• C-b " ou C-b % pour diviser

Le reste viendra naturellement avec la pratique. Et si vous oubliez : C-b ? affiche tous les raccourcis !

Scénario pratique : maintenance d’un serveur

Voyons tmux en action dans une situation réelle de DevOps.

Le contexte

Vous devez :

1. Mettre à jour un serveur (ça peut prendre 20-30 minutes)
2. Surveiller les logs pendant la mise à jour
3. Être prêt à intervenir si problème

Sans tmux, vous garderiez 3 fenêtres de terminal ouvertes. Si votre connexion coupe, tout est perdu.

La solution avec tmux

1. Connexion au serveur et création de session

   ssh admin@serveur-prod
   tmux new -s maintenance

   Vous êtes dans tmux. Donnez à votre window un nom explicite :

   C-b , puis tapez update et Entrée.

2. Créer un layout à 2 panneaux

   Nous voulons voir la mise à jour en haut et les logs en bas.

   Divisez horizontalement : C-b "

   Votre écran est maintenant coupé en deux.

3. Dans le panneau du haut : préparer la mise à jour

   Vous devriez être dans le panneau du haut. Sinon : C-b flèche haut

   # Vérifier d'abord ce qui va être mis à jour
   sudo apt update
   apt list --upgradable

4. Dans le panneau du bas : suivre les logs

   Passez au panneau du bas : C-b flèche bas

   # Suivre les logs système en temps réel
   sudo journalctl -f -u apt-daily* -u unattended-upgrades

5. Retour en haut pour lancer la mise à jour

   C-b flèche haut

   sudo apt upgrade -y

   La mise à jour commence. Dans le panneau du bas, vous voyez les logs en temps réel.

6. Vous pouvez partir tranquillement

   C-b d pour détacher.

   Vous pouvez fermer votre terminal, aller déjeuner, éteindre votre PC. La mise à jour continue.

7. Revenir vérifier plus tard

   ssh admin@serveur-prod
   tmux attach -t maintenance

   Tout est là : la mise à jour est terminée (ou en cours), les logs ont tout enregistré.

C'est la vraie valeur de tmux

Ce scénario illustre pourquoi tmux est indispensable en DevOps :

• Tâches longues sans stress de déconnexion
• Vue simultanée de plusieurs informations
• Possibilité de partir et revenir

Configuration de tmux

tmux est configurable via un fichier ~/.tmux.conf. Ce fichier n’existe pas par défaut ; vous devez le créer.

Pourquoi configurer tmux ?

Quelques irritants du comportement par défaut :

• Le préfixe C-b demande de tordre les doigts (C-a est plus naturel)
• La souris ne fonctionne pas (pas de clic pour changer de pane)
• Les numéros de windows commencent à 0 (peu intuitif)
• L’historique de scroll est limité

Configuration de départ recommandée

Créez le fichier ~/.tmux.conf avec ce contenu :

# ============================================
# Configuration tmux pour débutants
# ============================================

# -------------------------------------------
# PRÉFIXE : Changer C-b pour C-a (plus accessible)
# -------------------------------------------
# C-a est plus facile à taper que C-b
# C-a C-a envoie C-a au programme (utile pour Bash)
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# -------------------------------------------
# SOURIS : Activer le support souris
# -------------------------------------------
# Permet de :
# - Cliquer pour changer de pane
# - Scroller pour voir l'historique
# - Redimensionner les panes en glissant les bordures
set -g mouse on

# -------------------------------------------
# NUMÉROTATION : Commencer à 1 (pas 0)
# -------------------------------------------
# Plus logique : window 1, 2, 3... pane 1, 2, 3...
set -g base-index 1
setw -g pane-base-index 1

# -------------------------------------------
# HISTORIQUE : Plus de lignes de scroll
# -------------------------------------------
# Par défaut : 2000. On augmente à 50000.
set -g history-limit 50000

# -------------------------------------------
# COULEURS : Support 256 couleurs
# -------------------------------------------
set -g default-terminal "screen-256color"

# -------------------------------------------
# RACCOURCIS : Division plus intuitive
# -------------------------------------------
# | pour diviser verticalement (comme un mur vertical)
# - pour diviser horizontalement (comme un trait horizontal)
# -c "#{pane_current_path}" garde le répertoire courant
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# -------------------------------------------
# NAVIGATION : Alt+flèches sans préfixe
# -------------------------------------------
# Plus rapide que C-a flèches
bind -n M-Left select-pane -L
bind -n M-Right select-pane -R
bind -n M-Up select-pane -U
bind -n M-Down select-pane -D

# -------------------------------------------
# RECHARGEMENT : C-a r recharge la config
# -------------------------------------------
bind r source-file ~/.tmux.conf \; display "Config rechargée!"

Pour appliquer cette configuration :

# Si tmux n'est pas lancé, il suffit de le lancer
tmux new -s test

# Si vous êtes déjà dans tmux, rechargez :
# Soit avec la commande
tmux source-file ~/.tmux.conf

# Soit avec le raccourci (si configuré)
# C-a r

Explication ligne par ligne

Chaque section du fichier est commentée. Prenez le temps de lire et comprendre ce que fait chaque option. Vous pourrez ensuite la modifier selon vos préférences.

Après configuration : les nouveaux raccourcis

Si vous utilisez la configuration ci-dessus, vos raccourcis changent :

Avant (défaut)	Après (configuré)
C-b (préfixe)	C-a (préfixe)
C-b " (diviser horiz.)	C-a - (plus intuitif)
C-b % (diviser vert.)	`C-a
C-b flèches (navigation)	Alt+flèches (sans préfixe !)

Glissez pour voir

Dépannage : problèmes courants

”tmux: command not found”

Cause : tmux n’est pas installé.

Solution : installez-le (voir section Installation).

Je suis perdu, je ne sais pas si je suis dans tmux

Solution : regardez en bas de votre écran. S’il y a une barre de statut (généralement verte), vous êtes dans tmux. Sinon, vous n’y êtes pas.

Autre méthode :

echo $TMUX

Si la commande affiche un chemin (ex: /tmp/tmux-1000/default), vous êtes dans tmux. Si c’est vide, vous n’y êtes pas.

Comment voir mes sessions existantes ?

tmux ls

Si vous avez des sessions :

api: 3 windows (created Thu Feb  6 09:00:00 2026)
monitoring: 1 windows (created Thu Feb  6 10:00:00 2026)

Si vous n’avez pas de sessions :

no server running on /tmp/tmux-1000/default

J’ai fermé mon terminal par erreur, j’ai tout perdu ?

*Non -l /home/bob/Projets/test-astro-5/src/content/docs/docs/outils/systeme/tmux.mdx C’est justement le point de tmux. Reconnectez-vous (SSH si c’était distant) et tapez :

tmux attach

Vous retrouverez votre session.

Mes couleurs sont bizarres / l’affichage est cassé

Cause : problème de compatibilité terminal.

Solution : ajoutez dans ~/.tmux.conf :

set -g default-terminal "screen-256color"

Puis rechargez : tmux source-file ~/.tmux.conf

La souris ne fonctionne pas

Solution : ajoutez dans ~/.tmux.conf :

set -g mouse on

Je n’arrive pas à scroller pour voir l’historique

Solution : entrez en “mode copie” avec C-b [ (ou C-a [ si reconfiguré). Vous pouvez alors scroller avec les flèches ou la molette. Appuyez sur q pour quitter ce mode.

À retenir

Récapitulons les points essentiels de ce guide :

1. tmux découple terminal et connexion : vos processus survivent aux déconnexions SSH, coupures réseau, fermeture de terminal

2. Trois niveaux d’organisation : Session (projet) → Window (onglet) → Pane (division d’écran)

3. Le préfixe est la clé : par défaut Ctrl+B, toutes les commandes tmux commencent par là

4. Les 4 commandes indispensables :

   • tmux new -s nom — créer une session
   • C-b d — se détacher (la session continue)
   • tmux ls — lister les sessions
   • tmux attach -t nom — se rattacher

5. Configuration dans ~/.tmux.conf : personnalisez le préfixe, activez la souris, ajoutez vos raccourcis

6. tmux est déjà partout : sur la plupart des serveurs Linux, il est déjà installé

Prochaines étapes

Zellij : alternative moderne Multiplexeur plus accessible avec interface intuitive et configuration simplifiée

mise : gestionnaire d'outils Gérer les versions de tmux et autres outils CLI

Vim : éditeur terminal Accompagnement idéal de tmux pour éditer dans le terminal

SSH : connexion sécurisée Comprendre SSH pour mieux utiliser tmux sur serveurs distants

×

📖 Voir la documentation →