Commande useradd : options, utilisation de -m et -s, mot de passe avec passwd

Environnement de testFamille RHELAlmaLinux 9.8shadow-utils 4.9Compte rootDebian 12 compte standard
Utilisateurs · groupesuseraddpasswdEmplacement/usr/sbin/useradd

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 user1

D'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 root
root:x:0:0:root:/root:/bin/bash

De 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.defs
CREATE_HOME	yes

Sur 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 -D
GROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/sh
SKEL=/etc/skel
CREATE_MAIL_SPOOL=no
LOG_INIT=yes

Sur 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 user1

Les fichiers copiés dans le répertoire personnel se trouvent dans /etc/skel.

ls -lA /etc/skel
total 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 .bashrc

Le /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.

OptionCopierDescription
-m, --create-homeCrée le répertoire personnel et copie les fichiers de /etc/skel
-M, --no-create-homeNe crée pas de répertoire personnel
-s, --shellDéfinit le shell de connexion
-g, --gidDéfinit le groupe principal, uniquement un groupe existant
-G, --groupsDéfinit les groupes secondaires, séparés par des virgules s'il y en a plusieurs
-c, --commentRemplit le champ de description (GECOS)
-D, --defaultsAffiche les valeurs par défaut ; avec des options, les modifie
OptionCopierDescription
-d, --home-dirDéfinit le chemin du répertoire personnel
-u, --uidDéfinit l'UID
-e, --expiredateDéfinit la date d'expiration du compte (YYYY-MM-DD)
-f, --inactiveNombre de jours après l'expiration du mot de passe avant que le compte ne devienne inutilisable
-r, --systemCrée un compte système
-N, --no-user-groupNe crée pas de groupe portant le même nom que le compte
-p, --passwordDé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)	ALL
useradd -G wheel user2

Si 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.

Simulateur de la commande useraddshadow-utils 4.9
[root@server work]#
C'est un serveur AlmaLinux virtuel qui fonctionne uniquement dans le navigateur ; les comptes créés apparaissent dans le tableau de gauche et dans l'arborescence /home, et ↑↓ rappelle les commandes saisies auparavant.

4️⃣ Exemples pratiques de la commande useradd

  • ↪️ Créer un compte de développement et erreurs fréquentes au début

🔲 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/bash

Le 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/devuser

Juste 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 exist

Quand 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/bsh

Une 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:!!:20771

Vous 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 -D
GROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yes

HOME, 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.defs
HOME_MODE	0700
UID_MIN                  1000
UID_MAX                 60000
SYS_UID_MIN               201
SYS_UID_MAX               999
ENCRYPT_METHOD SHA512
USERGROUPS_ENAB yes
CREATE_HOME	yes

HOME_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 user1
Changing 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/passwd
shadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64

Sur 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.

OptionRôle
-S, --statusAffiche l'état du mot de passe sur une ligne
-l, --lockVerrouille le mot de passe en ajoutant ! devant le hachage
-u, --unlockDéverrouille le mot de passe
-d, --deleteSupprime le mot de passe
-e, --expireFait expirer le mot de passe tout de suite ; changement à la prochaine connexion
-x, --maximumNombre maximal de jours d'utilisation du mot de passe
-n, --minimumNombre minimal de jours d'utilisation du mot de passe
-w, --warningJours d'avertissement avant l'expiration
-i, --inactiveJours après l'expiration avant la désactivation du compte
--stdinReç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 root
root 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 nobody
Only 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 -S
webuser P 2026-01-20 0 99999 7 -1

La 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

Sur le serveur AlmaLinux 9.8, /usr/sbin/adduser était un lien vers useradd, donc les deux commandes étaient le même programme. Sur le serveur Debian 12, adduser est un programme distinct du paquet adduser, et le manuel officiel le décrit comme un programme qui enveloppe des outils de plus bas niveau comme useradd et demande le champ de description et le mot de passe.

useradd se trouve dans /usr/sbin. Le /etc/login.defs du serveur Debian 12 ne mettait pas /usr/sbin dans le PATH des comptes ordinaires, et taper [useradd -D] avec un compte ordinaire s'est terminé par [command not found]. Ajoutez [sudo] ou exécutez-la avec le compte root.

Le passwd de la famille RHEL, comme AlmaLinux, a l'option --stdin, qui reçoit le nouveau mot de passe depuis l'entrée standard, et seul root peut l'utiliser. Le passwd du serveur Debian 12 n'avait pas cette option. Les deux serveurs avaient [chpasswd], qui, d'après le manuel officiel, reçoit depuis l'entrée standard des lignes de la forme [compte:mot_de_passe] et définit en une fois les mots de passe de plusieurs comptes. Les mots de passe écrits directement sur la ligne de commande peuvent rester dans l'historique du shell.

ℹ️ 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.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Prouvez que vous êtes humain : 0   +   1   =