Commande useradd : options, utilisation de -m et -s, mot de passe avec passwd
La commande useradd ajoute un nouveau compte utilisateur sous Linux, et la commande passwd définit ou verrouille le mot de passe de ce compte. En comparant les valeurs par défaut de useradd et les fichiers de configuration sur des serveurs AlmaLinux 9 et Debian 12, on a constaté qu'AlmaLinux était configuré pour créer le répertoire personnel et utiliser bash comme shell de connexion même sans option, alors que Debian n'avait aucun réglage pour créer le répertoire personnel et que son shell par défaut était sh.
La sortie ci-dessous a été obtenue sur un serveur AlmaLinux 9.8 avec le compte root et sur un serveur Debian 12 avec un compte ordinaire. Les dates de changement de mot de passe, les noms des comptes de test et les numéros de version des paquets shadow-utils et passwd ont été remplacés par des valeurs d'exemple.
1️⃣ Utilisation de la commande useradd
La forme de base est [useradd options nom_du_compte]. Comme elle modifie /etc/passwd et /etc/shadow, qui contiennent les informations des comptes, vous l'exécutez avec le compte root ou avec sudo.
useradd user1D'après le tableau des codes de sortie du manuel officiel, useradd se termine par 0 en cas de succès et par 9 si un compte du même nom existe déjà. Vérifiez le compte créé avec id ou getent passwd ; le format de sortie de id est le suivant.
uid=1000(user1) gid=1000(user1) groups=1000(user1)L'UID d'un nouveau compte prend la valeur qui suit le plus grand numéro déjà utilisé, à partir de UID_MIN 1000 dans /etc/login.defs. Un groupe portant le même nom que le compte est créé en même temps.
Une ligne de /etc/passwd compte sept champs séparés par des deux-points. La ligne du compte root a été consultée sur le serveur AlmaLinux.
getent passwd rootroot:x:0:0:root:/root:/bin/bashDe gauche à droite, on trouve le nom du compte, le champ du mot de passe, l'UID, le GID, la description, le répertoire personnel et le shell de connexion. Le x du champ du mot de passe signifie que le véritable hachage du mot de passe est stocké à part dans /etc/shadow.
2️⃣ Créer le répertoire personnel avec useradd -m
L'option -m crée sous /home un répertoire personnel au nom du compte et y copie les fichiers de /etc/skel. La création du répertoire personnel sans -m dépend de la valeur CREATE_HOME de /etc/login.defs.
grep CREATE_HOME /etc/login.defsCREATE_HOME yesSur le serveur AlmaLinux 9.8, CREATE_HOME vaut yes, donc il suffit de taper useradd user1 pour que /home/user1 soit créé. Dans le /etc/login.defs du serveur Debian 12, le même grep n'a trouvé aucune ligne et s'est terminé avec le code de sortie 1. Le manuel officiel indique que si CREATE_HOME n'est pas activé, aucun répertoire personnel n'est créé sans -m.
Sur un serveur Debian 12, vérifiez aussi le shell par défaut. En affichant les valeurs par défaut avec un compte ordinaire, SHELL valait /bin/sh.
/usr/sbin/useradd -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/sh
SKEL=/etc/skel
CREATE_MAIL_SPOOL=no
LOG_INIT=yesSur le serveur Debian 12, /bin/sh était lié à dash. Pour qu'un nouveau compte se connecte avec bash, indiquez ensemble le répertoire personnel et le shell.
useradd -m -s /bin/bash user1Les fichiers copiés dans le répertoire personnel se trouvent dans /etc/skel.
ls -lA /etc/skeltotal 12
-rw-r--r--. 1 root root 18 Apr 30 2024 .bash_logout
-rw-r--r--. 1 root root 141 Apr 30 2024 .bash_profile
-rw-r--r--. 1 root root 492 Apr 30 2024 .bashrcLe /etc/skel du serveur AlmaLinux contenait trois fichiers de configuration de bash, et le serveur Debian 12 avait .bash_logout, .bashrc et .profile. Si chaque nouveau compte doit recevoir certains fichiers de configuration, placez-les à l'avance dans /etc/skel ; pour utiliser un autre répertoire, indiquez-le avec l'option -k.
À l'inverse, avec -M, aucun répertoire personnel n'est créé même si CREATE_HOME vaut yes.
3️⃣ Options de useradd
La liste des options s'affiche avec useradd --help. Les options courantes de shadow-utils 4.9 sur le serveur AlmaLinux 9.8 sont les suivantes.
| Option | Copier | Description |
|---|---|---|
| -m, --create-home | Crée le répertoire personnel et copie les fichiers de /etc/skel | |
| -M, --no-create-home | Ne crée pas de répertoire personnel | |
| -s, --shell | Définit le shell de connexion | |
| -g, --gid | Définit le groupe principal, uniquement un groupe existant | |
| -G, --groups | Définit les groupes secondaires, séparés par des virgules s'il y en a plusieurs | |
| -c, --comment | Remplit le champ de description (GECOS) | |
| -D, --defaults | Affiche les valeurs par défaut ; avec des options, les modifie |
| Option | Copier | Description |
|---|---|---|
| -d, --home-dir | Définit le chemin du répertoire personnel | |
| -u, --uid | Définit l'UID | |
| -e, --expiredate | Définit la date d'expiration du compte (YYYY-MM-DD) | |
| -f, --inactive | Nombre de jours après l'expiration du mot de passe avant que le compte ne devienne inutilisable | |
| -r, --system | Crée un compte système | |
| -N, --no-user-group | Ne crée pas de groupe portant le même nom que le compte | |
| -p, --password | Définit un mot de passe chiffré |
Plusieurs options peuvent s'écrire ensemble sur une seule ligne. Voici un exemple qui fixe en une fois le chemin du répertoire personnel, le shell et le champ de description.
useradd -m -d /home/web1 -s /bin/bash -c 'Web user' web1-G ajoute des groupes en laissant le groupe principal tel quel. Le /etc/sudoers du serveur AlmaLinux contenait une ligne autorisant le groupe wheel à exécuter toutes les commandes. Un compte placé dans le groupe wheel peut donc exécuter des commandes avec les droits root via sudo.
grep -E '^%wheel' /etc/sudoers%wheel ALL=(ALL) ALLuseradd -G wheel user2Si l'on consulte avec id un compte créé ainsi, le champ groups affiche 10(wheel) en plus.
uid=1001(user2) gid=1001(user2) groups=1001(user2),10(wheel)-r crée un compte système utilisé par les programmes de service. L'UID est choisi entre SYS_UID_MIN 201 et SYS_UID_MAX 999 de /etc/login.defs. D'après le manuel officiel, un compte -r ne reçoit pas de répertoire personnel même si CREATE_HOME vaut yes, et un compte qui n'a jamais besoin de se connecter reçoit /sbin/nologin comme shell.
useradd -r -s /sbin/nologin svc1-p est l'option qui reçoit la valeur d'un mot de passe chiffré. Le manuel officiel la déconseille, car cette valeur peut être visible des utilisateurs qui consultent la liste des processus ; définissez donc le mot de passe avec passwd après avoir créé le compte.
🔲 Simulateur de la commande useradd
Dans le simulateur ci-dessous, vous pouvez saisir vous-même les étapes : créer un compte avec useradd, définir son mot de passe avec passwd, puis le vérifier avec id et getent.
4️⃣ Exemples pratiques de la commande useradd
🔲 Créer un compte de développement
Un compte destiné à un développeur a été créé en une seule ligne, avec le répertoire personnel, le shell bash, le champ de description et le groupe wheel. useradd s'est terminé sans rien afficher, et les valeurs indiquées apparaissaient telles quelles dans la sortie de id et dans la ligne de /etc/passwd.
~]# useradd -m -s /bin/bash -c 'Dev User' -G wheel devuser
~]# id devuser
uid=1001(devuser) gid=1001(devuser) groups=1001(devuser),10(wheel)
~]# grep '^devuser:' /etc/passwd
devuser:x:1001:1001:Dev User:/home/devuser:/bin/bashLe répertoire personnel a été créé avec les permissions drwx------, que seul ce compte peut ouvrir, et les trois fichiers de configuration de bash de /etc/skel y ont été copiés. Comme le serveur a CREATE_MAIL_SPOOL=yes, un fichier de spool de courrier de taille 0 a aussi été créé.
~]# ls -la /home/devuser
total 20
drwx------. 2 devuser devuser 4096 Nov 14 07:40 .
drwxr-xr-x. 4 root root 4096 Nov 14 07:40 ..
-rw-r--r--. 1 devuser devuser 18 Apr 30 2024 .bash_logout
-rw-r--r--. 1 devuser devuser 141 Apr 30 2024 .bash_profile
-rw-r--r--. 1 devuser devuser 554 Nov 3 02:28 .bashrc
~]# ls -l /var/spool/mail/devuser
-rw-rw----. 1 devuser mail 0 Nov 14 07:40 /var/spool/mail/devuserJuste après la création du compte, une consultation avec passwd -S affichait l'état LK.
~]# passwd -S devuser
devuser LK 2026-11-14 0 99999 7 -1 (Password locked.)Après avoir défini le mot de passe en le saisissant deux fois avec passwd devuser, une nouvelle consultation affichait l'état PS.
~]# passwd -S devuser
devuser PS 2026-11-14 0 99999 7 -1 (Password set, SHA512 crypt.)🔲 Erreurs fréquentes au début
En indiquant après -G un groupe qui n'existait pas encore, la commande s'est terminée avec le code de sortie 6 sans créer le compte. Les groupes ajoutés avec -G doivent être créés au préalable.
~]# useradd -G developers bob
useradd: group 'developers' does not existQuand le chemin du shell était mal écrit, une seule ligne d'avertissement est apparue et le compte a quand même été créé. Le chemin inexistant /bin/bsh était inscrit dans le dernier champ de /etc/passwd ; il faut donc revérifier ce champ après avoir créé le compte.
~]# useradd -s /bin/bsh bob
useradd: Warning: missing or non-executable shell '/bin/bsh'
~]# grep '^bob:' /etc/passwd
bob:x:1002:1002::/home/bob:/bin/bshUne autre erreur consiste à confondre -g minuscule et -G majuscule. Après avoir supprimé le bob précédent avec userdel -r et l'avoir recréé avec -g wheel, wheel est devenu le groupe principal, sans groupe portant le nom du compte.
~]# useradd -g wheel bob
~]# id bob
uid=1002(bob) gid=10(wheel) groups=10(wheel)Un compte créé avec -M n'a pas de répertoire personnel ; en y entrant avec su -, l'avertissement [su: warning: cannot change directory to /home/tempuser: No such file or directory] est apparu.
~]# useradd -M tempuser
~]# ls -ld /home/tempuser
ls: cannot access '/home/tempuser': No such file or directory
~]# su - tempuser -c pwd
su: warning: cannot change directory to /home/tempuser: No such file or directory
/root🔲 Lire le résultat de useradd
useradd n'affiche rien en cas de succès, donc vérifiez le résultat dans les fichiers d'informations des comptes. Dans /etc/group, devuser a été ajouté à la liste des membres à la fin de la ligne wheel ajoutée avec -G, et le groupe devuser, du même nom que le compte, avait un champ de membres vide.
~]# grep -E '^(wheel|devuser):' /etc/group
wheel:x:10:linuxuser,devuser
devuser:x:1001:Dans /etc/shadow, le deuxième champ valait [!!] avant la définition du mot de passe, et le troisième champ, 20771, est le nombre de jours comptés depuis le 1er janvier 1970, soit le 14 novembre 2026.
~]# grep '^devuser:' /etc/shadow | cut -d: -f1-3
devuser:!!:20771Vous pouvez saisir vous-même useradd, passwd et id dans le Simulateur de la commande useradd.
La durée d'utilisation du mot de passe et la date d'expiration d'un compte ainsi créé se définissent avec la commande chage.
5️⃣ Valeurs par défaut de useradd et /etc/login.defs
useradd -D lancé sans option affiche les valeurs par défaut enregistrées dans /etc/default/useradd. Voici le résultat sur le serveur AlmaLinux.
useradd -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yesHOME, SHELL et SKEL sont le chemin parent où sont créés les répertoires personnels, le shell par défaut et le répertoire contenant les fichiers à copier. GROUP=100 est le numéro du groupe par défaut users, utilisé quand aucun groupe portant le nom du compte n'est créé. INACTIVE=-1 et le EXPIRE vide indiquent qu'aucune désactivation après expiration du mot de passe ni aucune date d'expiration du compte n'ont été fixées.
Avec une option comme -s après -D, les valeurs de /etc/default/useradd sont modifiées au lieu d'afficher les valeurs par défaut. Pour seulement les vérifier, exécutez -D seul.
La plage d'UID, les permissions du répertoire personnel et la méthode de stockage des mots de passe se définissent dans /etc/login.defs.
grep -E '^(UID_MIN|UID_MAX|SYS_UID_MIN|SYS_UID_MAX|HOME_MODE|USERGROUPS_ENAB|ENCRYPT_METHOD|CREATE_HOME)' /etc/login.defsHOME_MODE 0700
UID_MIN 1000
UID_MAX 60000
SYS_UID_MIN 201
SYS_UID_MAX 999
ENCRYPT_METHOD SHA512
USERGROUPS_ENAB yes
CREATE_HOME yesHOME_MODE 0700 signifie que les nouveaux répertoires personnels sont créés avec des permissions que seul ce compte peut ouvrir, et ENCRYPT_METHOD SHA512 signifie que les mots de passe définis avec passwd sont stockés sous forme de hachage SHA-512. USERGROUPS_ENAB yes est le réglage qui crée un groupe du même nom pour chaque nouveau compte.
Le /etc/login.defs du serveur Debian 12 avait aussi les mêmes UID_MIN 1000 et ENCRYPT_METHOD SHA512, mais pas de lignes HOME_MODE ni CREATE_HOME. La sortie de useradd -D sous Debian contenait CREATE_MAIL_SPOOL=no, qui ne crée pas de fichier de spool de courrier.
6️⃣ Utilisation de la commande passwd
Avec un nom de compte, la commande passwd change le mot de passe de ce compte ; sans nom, elle change celui du compte actuellement connecté. Seul root peut changer le mot de passe d'un autre compte.
passwd user1Changing password for user user1.
New password:
Retype new password:
passwd: all authentication tokens updated successfully.Le mot de passe saisi ne s'affiche pas à l'écran et n'est enregistré que si les deux saisies sont identiques. Si elles diffèrent, [Sorry, passwords do not match.] apparaît et le nouveau mot de passe est redemandé. Sur le serveur AlmaLinux, la ligne pam_pwquality qui vérifie les mots de passe dans la configuration PAM a retry=3, donc le mot de passe est demandé jusqu'à trois fois au total.
La longueur minimale par défaut de pwquality est de 8 caractères, donc un mot de passe plus court reçoit [BAD PASSWORD: The password is shorter than 8 characters]. Sur le serveur AlmaLinux 9.8, la ligne enforce_for_root de pwquality.conf était commentée, mais la même valeur figurait sur la ligne de configuration PAM. Ainsi, même en saisissant un mot de passe court en root, le nouveau mot de passe a été redemandé après l'avertissement, et tout s'est terminé par [Password change has been aborted.].
Si un compte ordinaire peut changer son propre mot de passe, c'est grâce aux permissions de deux fichiers.
stat -c "%A %U %G %n" /usr/bin/passwd /etc/shadow-rwsr-xr-x root root /usr/bin/passwd
---------- root root /etc/shadow/etc/shadow a tous ses champs de permissions vides, donc seul root peut le lire et l'écrire. /usr/bin/passwd a un s (setuid) dans le champ du propriétaire ; même lancé par un compte ordinaire, il s'exécute avec les droits root et écrit le nouveau mot de passe dans /etc/shadow.
7️⃣ Options de passwd et vérification de l'état
Les options de passwd diffèrent, car chaque distribution fournit un programme différent. Sur le serveur AlmaLinux, passwd se trouvait dans un paquet passwd distinct de shadow-utils.
rpm -qf /usr/sbin/useradd /usr/bin/passwdshadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64Sur le serveur Debian 12, useradd et passwd se trouvaient tous deux dans le paquet passwd. D'après passwd --help sur le serveur AlmaLinux 9.8, les options courantes sont les suivantes, et seul root peut toutes les utiliser.
| Option | Rôle |
|---|---|
| -S, --status | Affiche l'état du mot de passe sur une ligne |
| -l, --lock | Verrouille le mot de passe en ajoutant ! devant le hachage |
| -u, --unlock | Déverrouille le mot de passe |
| -d, --delete | Supprime le mot de passe |
| -e, --expire | Fait expirer le mot de passe tout de suite ; changement à la prochaine connexion |
| -x, --maximum | Nombre maximal de jours d'utilisation du mot de passe |
| -n, --minimum | Nombre minimal de jours d'utilisation du mot de passe |
| -w, --warning | Jours d'avertissement avant l'expiration |
| -i, --inactive | Jours après l'expiration avant la désactivation du compte |
| --stdin | Reçoit le nouveau mot de passe depuis l'entrée standard |
passwd --help sur le serveur Debian 12 n'avait pas --stdin, mais avait -a, qui affiche avec -S l'état de tous les comptes.
-S affiche l'état du mot de passe sur une ligne.
passwd -S rootroot PS 2026-01-15 0 99999 7 -1 (Password set, SHA512 crypt.)Les champs sont, dans l'ordre, le nom du compte, l'état, la date du dernier changement de mot de passe, les jours minimum, les jours maximum, les jours d'avertissement et les jours d'inactivité. L'état PS est un mot de passe utilisable, LK un mot de passe verrouillé, et NP signifie qu'il n'y a pas de mot de passe. D'après le manuel officiel, un compte créé par useradd a un mot de passe désactivé ; il ne peut donc pas se connecter par mot de passe tant qu'il n'en a pas reçu un avec passwd.
Sous AlmaLinux, seul root peut utiliser -S. Quand root a emprunté les droits du compte nobody avec runuser pour l'exécuter, la commande s'est terminée par [Only root can do that.].
runuser -u nobody -- passwd -S nobodyOnly root can do that.Sur le serveur Debian 12, un compte ordinaire pouvait vérifier son propre état. Le champ d'état affichait P au lieu de PS, et il n'y avait pas d'explication entre parenthèses à la fin.
passwd -Swebuser P 2026-01-20 0 99999 7 -1La consultation de l'état de root avec le même compte ordinaire a été bloquée par [You may not view or modify password information for root.].
Même après le verrouillage du mot de passe avec -l, d'après le manuel officiel, la connexion reste possible par une autre authentification, comme les clés SSH. Pour bloquer le compte entier, utilisez [chage -E 0 nom_du_compte].
🔢 FAQ & contenus recommandés
Suppression de compte
Commande userdel : options, suppression du répertoire personnel avec -r et erreurs de suppression de compte Linux
Un article qui explique comment supprimer un compte avec userdel et effacer aussi son répertoire personnel et son fichier de courrier avec l'option -r.
ℹ️ Mention d'affiliation
Le contenu de ce site contient des liens d'affiliation. Lorsqu'un visiteur achète un produit ou un service via l'un de ces liens, le site perçoit une commission du vendeur. Le montant payé par l'acheteur(il baisse lors des promotions ↓), lui, n'augmente pas. Les prix, remises et stocks indiqués correspondent à la date de rédaction et peuvent différer ; vérifiez-les donc auprès du vendeur avant d'acheter. Les produits sont choisis et évalués selon nos propres critères, et les commissions n'influencent ni l'ordre de présentation ni le contenu des évaluations.