Installer Cockpit sous Debian : l'administration Linux dans le navigateur
Cockpit affiche l'état d'un serveur Linux dans un navigateur et permet d'agir dessus sans quitter les outils du système. Installation sur Debian 13, connexion, port d'écoute et premières tâches.
Cockpit est une interface web d'administration pour serveurs Linux. Le projet la présente comme destinée aussi bien aux débutants sous Linux, y compris les administrateurs Windows, qu'aux experts qui veulent une vue d'ensemble d'une machine. Son principe : Cockpit utilise les API et les commandes déjà présentes sur le système, sans ajouter sa propre couche. Ce que vous faites dans Cockpit reste donc visible et modifiable en ligne de commande, et inversement.
Testez l'installation sur une machine de lab, et prenez un instantané avant de l'ajouter à un serveur de production : Cockpit ouvre un nouveau point d'accès d'administration sur le réseau.
Debian 9 et Cockpit : où en est-on
Les anciens guides « Cockpit sous Debian 9 » visent une version qui n'est plus maintenue : Debian 9 « stretch » est sortie du support de sécurité en juillet 2020 et du LTS fin juin 2022. Le projet Cockpit indique d'ailleurs que Cockpit est disponible dans Debian depuis la version 10. La version stable actuelle est Debian 13 « trixie », et c'est elle que vise la suite.
Au 12 octobre 2026, l'archive Debian propose Cockpit 337 dans trixie et une version plus récente dans trixie-backports. Le projet Cockpit publie une nouvelle version toutes les deux semaines, ce qui explique l'écart.
Le serveur du lab
| Hôte | Rôle | Interface | Adresse |
|---|---|---|---|
| srv-deb01 | Debian 13, Cockpit | ens18 | 192.168.10.40 |
| poste | navigateur d'administration | — | 192.168.10.50 |
Prérequis : un compte utilisateur membre du groupe sudo, le réseau configuré, et l'accès au dépôt Debian.
Installer Cockpit
Option 1 : le paquet de Debian 13
C'est la voie la plus simple, et la version suit les mises à jour de sécurité de Debian stable :
sudo apt update
sudo apt install cockpit
Option 2 : la dernière version via les backports
Le projet Cockpit recommande d'activer le dépôt backports de Debian pour obtenir la dernière version. Ses commandes, à lancer dans un shell compatible POSIX comme bash :
. /etc/os-release
echo "deb http://deb.debian.org/debian ${VERSION_CODENAME}-backports main" | sudo tee /etc/apt/sources.list.d/backports.list
sudo apt update
sudo apt install -t ${VERSION_CODENAME}-backports cockpit
Le projet précise un point qu'on oublie facilement : lors des mises à jour des paquets liés à Cockpit, il faut garder l'option -t ...-backports, sinon les dépendances ne viennent pas des backports.
| Source | Avantage | Point d'attention |
|---|---|---|
| dépôt Debian 13 | stable, mises à jour de sécurité Debian | version plus ancienne |
| trixie-backports | dernières fonctions | penser à -t trixie-backports à chaque mise à jour |
Le service démarre à la demande
Sur Debian, l'installation active l'unité cockpit.socket, qui écoute sur le port 9090. Cockpit ne tourne pas en permanence : selon le projet, il démarre à la demande grâce à l'activation par socket de systemd. Vérifiez l'état du socket :
systemctl status cockpit.socket
Se connecter
Depuis le poste, ouvrez https://192.168.10.40:9090. La documentation du projet indique de se connecter avec un compte utilisateur du système et son mot de passe. Selon le projet, Cockpit utilise par défaut les comptes et les privilèges normaux du système : ce que le compte peut faire en ligne de commande, il peut le faire dans Cockpit.
Si la page ne s'affiche pas, vérifiez dans l'ordre que cockpit.socket est actif, que le port 9090 n'est pas filtré par un pare-feu entre le poste et le serveur, et que vous utilisez bien https://.
Changer le port d'écoute
Le port 9090 est celui par défaut de cockpit-ws. Pour le changer, la documentation de Cockpit demande de créer le fichier /etc/systemd/system/cockpit.socket.d/listen.conf :
[Socket]
ListenStream=
ListenStream=443
La première ligne vide est volontaire : elle réinitialise la liste des ports, et désactive donc le 9090 de l'unité d'origine. Pour écouter sur une seule adresse, écrivez ListenStream=192.168.10.40:443 et ajoutez FreeBind=yes, recommandé par le projet dans ce cas. Puis appliquez :
sudo systemctl daemon-reload
sudo systemctl restart cockpit.socket
Ce que l'on fait avec Cockpit
Le projet liste notamment ces tâches :
- Consulter et rechercher les journaux du système, pratique pour suivre un service qui redémarre en boucle.
- Gérer les services systemd : état, démarrage, arrêt, activation au boot.
- Inspecter et modifier le réseau, y compris une agrégation de liens.
- Mettre à jour les logiciels et gérer les comptes utilisateurs.
- Ouvrir un terminal dans le navigateur, utile depuis un poste qui n'est pas sous Linux.
Cockpit sait aussi passer d'un serveur à l'autre : il suffit qu'il écoute sur la machine à laquelle se connecte le navigateur, il joint les autres en SSH.
« ifconfig : commande introuvable » sur Debian
C'est souvent en cherchant l'adresse du serveur pour s'y connecter qu'on tombe sur ce message. ifconfig appartient au paquet net-tools : si ce paquet n'est pas installé, la commande n'existe pas. L'outil courant est ip, du paquet iproute2 ; sa page de manuel précise que ip address show affiche les adresses IPv4 et IPv6 de toutes les interfaces, et que le mot show peut être omis :
ip address show
ip address show dev ens18
Si un vieux script exige vraiment ifconfig, sudo apt install net-tools le réinstalle. La page de manuel d'ifconfig renvoie elle-même vers ip link pour afficher les adresses matérielles.
Pour aller plus loin
Cockpit rend service sur un serveur réseau comme celui du guide DHCP et relais DHCP sous Debian, dont il affiche les journaux. Pour la configuration d'un bond, voyez l'agrégation de liens sous Linux. Les commandes de base sont dans la liste des commandes Linux, les autres guides dans la rubrique Serveurs Linux, et l'ensemble des tutoriels Linux et Windows sur la page d'accueil.
Questions fréquentes
Qu'est-ce que Cockpit sous Linux ?
C'est une interface web d'administration de serveurs. Elle s'appuie sur les API et commandes déjà présentes sur le système, si bien que l'on peut alterner entre Cockpit, la ligne de commande et d'autres outils comme Ansible.
Sur quel port Cockpit écoute-t-il ?
Par défaut sur le port TCP 9090, en HTTPS : https://adresse-du-serveur:9090. Le port se change avec un fichier de surcharge de l'unité cockpit.socket, comme le décrit la documentation du projet.
Faut-il activer le service après l'installation sur Debian ?
Non. Le paquet Debian active cockpit.socket lors d'une nouvelle installation. Cockpit démarre ensuite à la demande, à la première connexion, grâce à l'activation par socket de systemd.
Quel compte utiliser pour se connecter ?
Un compte utilisateur du système, avec son mot de passe habituel. Cockpit reprend les privilèges normaux de ce compte, ce qui évite de créer des identifiants à part.
Pourquoi « ifconfig : commande introuvable » ?
ifconfig fait partie du paquet net-tools, qui n'est pas présent sur votre système. Utilisez ip address show (iproute2), ou installez net-tools si un script en dépend.