Comando useradd: opciones, uso de -m y -s y contraseñas con passwd

Entorno de pruebaFamilia RHELAlmaLinux 9.8shadow-utils 4.9Cuenta rootDebian 12 cuenta normal
Usuarios · gruposuseraddpasswdUbicación/usr/sbin/useradd

El comando useradd añade una nueva cuenta de usuario en Linux, y el comando passwd fija o bloquea la contraseña de esa cuenta. Al comparar los valores predeterminados de useradd y los archivos de configuración en servidores AlmaLinux 9 y Debian 12, AlmaLinux estaba configurado para crear el directorio personal y usar bash como shell de inicio de sesión incluso sin opciones, mientras que Debian no tenía ninguna opción para crear el directorio personal y su shell predeterminado era sh.

La salida de abajo se obtuvo en un servidor AlmaLinux 9.8 con la cuenta root y en un servidor Debian 12 con una cuenta normal. Las fechas de cambio de contraseña, los nombres de las cuentas de prueba y los números de versión de los paquetes shadow-utils y passwd se han cambiado por valores de ejemplo.

1️⃣ Cómo usar el comando useradd

La forma básica es [useradd opciones nombre_de_cuenta]. Como modifica /etc/passwd y /etc/shadow, que guardan la información de las cuentas, se ejecuta con la cuenta root o con sudo.

useradd user1

Según la tabla de códigos de salida del manual oficial, useradd termina con 0 si tiene éxito y con 9 si ya existe una cuenta con el mismo nombre. La cuenta creada se comprueba con id o getent passwd, y el formato de salida de id es el siguiente.

uid=1000(user1) gid=1000(user1) groups=1000(user1)

El UID de una cuenta nueva se fija en el valor siguiente al número más alto ya en uso, a partir de UID_MIN 1000 de /etc/login.defs. También se crea un grupo con el mismo nombre que la cuenta.

Una línea de /etc/passwd tiene siete campos separados por dos puntos. Se consultó la línea de la cuenta root en el servidor AlmaLinux.

getent passwd root
root:x:0:0:root:/root:/bin/bash

De izquierda a derecha son el nombre de la cuenta, el campo de contraseña, el UID, el GID, la descripción, el directorio personal y el shell de inicio de sesión. La x del campo de contraseña significa que el hash real de la contraseña se guarda aparte en /etc/shadow.

2️⃣ Crear el directorio personal con useradd -m

La opción -m crea bajo /home un directorio personal con el nombre de la cuenta y copia en él los archivos de /etc/skel. Si el directorio personal se crea también sin -m depende del valor de CREATE_HOME en /etc/login.defs.

grep CREATE_HOME /etc/login.defs
CREATE_HOME	yes

En el servidor AlmaLinux 9.8, CREATE_HOME vale yes, así que basta con escribir useradd user1 para que se cree /home/user1. En el /etc/login.defs del servidor Debian 12, el mismo grep no encontró ninguna línea y terminó con el código de salida 1. El manual oficial indica que, si CREATE_HOME no está activado, sin -m no se crea el directorio personal.

En un servidor Debian 12 conviene comprobar también el shell predeterminado. Al mostrar los valores predeterminados con una cuenta normal, SHELL era /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

En el servidor Debian 12, /bin/sh estaba enlazado a dash. Para que una cuenta nueva inicie sesión con bash, se indican juntos el directorio personal y el shell.

useradd -m -s /bin/bash user1

Los archivos que se copian al directorio personal están en /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

El /etc/skel del servidor AlmaLinux contenía tres archivos de configuración de bash, y el servidor Debian 12 tenía .bash_logout, .bashrc y .profile. Si hay archivos de configuración que deba recibir cada cuenta nueva, se dejan antes en /etc/skel; para usar otro directorio, se indica con la opción -k.

Por el contrario, si se añade -M no se crea el directorio personal aunque CREATE_HOME valga yes.

3️⃣ Opciones de useradd

La lista de opciones se muestra con useradd --help. Las opciones más usadas en shadow-utils 4.9 del servidor AlmaLinux 9.8 son las siguientes.

OpciónCopiarDescripción
-m, --create-homeCrea el directorio personal y copia los archivos de /etc/skel
-M, --no-create-homeNo crea el directorio personal
-s, --shellIndica el shell de inicio de sesión
-g, --gidIndica el grupo primario; solo grupos que ya existen
-G, --groupsIndica grupos suplementarios, separados por comas si son varios
-c, --commentRellena el campo de descripción (GECOS)
-D, --defaultsMuestra los valores predeterminados; con opciones, los cambia
OpciónCopiarDescripción
-d, --home-dirIndica la ruta del directorio personal
-u, --uidIndica el UID
-e, --expiredateIndica la fecha de caducidad de la cuenta (YYYY-MM-DD)
-f, --inactiveNúmero de días desde que caduca la contraseña hasta que la cuenta deja de poder usarse
-r, --systemCrea una cuenta del sistema
-N, --no-user-groupNo crea un grupo con el mismo nombre que la cuenta
-p, --passwordIndica una contraseña cifrada

Se pueden escribir varias opciones juntas en una línea. Este ejemplo fija a la vez la ruta del directorio personal, el shell y el campo de descripción.

useradd -m -d /home/web1 -s /bin/bash -c 'Web user' web1

-G añade grupos y deja el grupo primario como está. El /etc/sudoers del servidor AlmaLinux contenía una línea que permite al grupo wheel ejecutar todos los comandos. Por eso, una cuenta añadida al grupo wheel puede ejecutar comandos con privilegios de root mediante sudo.

grep -E '^%wheel' /etc/sudoers
%wheel	ALL=(ALL)	ALL
useradd -G wheel user2

Si se consulta con id una cuenta creada así, en el campo groups aparece 10(wheel) añadido.

uid=1001(user2) gid=1001(user2) groups=1001(user2),10(wheel)

-r crea una cuenta del sistema que usan los programas de servicio. El UID se elige entre SYS_UID_MIN 201 y SYS_UID_MAX 999 de /etc/login.defs. Según el manual oficial, una cuenta -r no recibe directorio personal aunque CREATE_HOME valga yes, y a una cuenta que nunca necesita iniciar sesión se le pone el shell /sbin/nologin.

useradd -r -s /sbin/nologin svc1

-p es la opción que recibe el valor de una contraseña cifrada. El manual oficial la desaconseja porque ese valor puede quedar a la vista de los usuarios que miran la lista de procesos, así que la contraseña se fija con passwd después de crear la cuenta.

🔲 Simulador del comando useradd

En el simulador de abajo se puede escribir uno mismo el proceso: crear una cuenta con useradd, fijar su contraseña con passwd y comprobarla con id y getent.

Simulador del comando useraddshadow-utils 4.9
[root@server work]#
Es un servidor AlmaLinux virtual que funciona solo dentro del navegador; las cuentas creadas aparecen en la tabla de la izquierda y en el árbol /home, y ↑↓ recupera los comandos escritos antes.

4️⃣ Ejemplos prácticos del comando useradd

  • ↪️ Crear una cuenta de desarrollo y errores frecuentes al empezar

🔲 Crear una cuenta de desarrollo

Se creó en una sola línea una cuenta para un desarrollador, con directorio personal, shell bash, campo de descripción y grupo wheel. useradd terminó sin mostrar nada, y los valores indicados se podían ver tal cual en la salida de id y en la línea 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

El directorio personal se creó con permisos drwx------, que solo esa cuenta puede abrir, y se copiaron los tres archivos de configuración de bash de /etc/skel. Como el servidor tiene CREATE_MAIL_SPOOL=yes, también se creó un archivo de cola de correo de tamaño 0.

~]# 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

Al consultar con passwd -S justo después de crear la cuenta, el estado era LK.

~]# passwd -S devuser
devuser LK 2026-11-14 0 99999 7 -1 (Password locked.)

Tras fijar la contraseña escribiéndola dos veces con passwd devuser, al volver a consultar el estado había cambiado a PS.

~]# passwd -S devuser
devuser PS 2026-11-14 0 99999 7 -1 (Password set, SHA512 crypt.)

🔲 Errores frecuentes al empezar

Al escribir tras -G un grupo que aún no existía, la cuenta no se creó y terminó con el código de salida 6. Los grupos que se añaden con -G deben crearse antes.

~]# useradd -G developers bob
useradd: group 'developers' does not exist

Cuando la ruta del shell se escribió mal, solo apareció una línea de advertencia y la cuenta se creó igualmente. En el último campo de /etc/passwd quedó registrada la ruta inexistente /bin/bsh, por lo que hay que revisar este campo después de crear la cuenta.

~]# 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

Otro error es confundir la -g minúscula con la -G mayúscula. Al borrar el bob anterior con userdel -r y volver a crearlo con -g wheel, wheel pasó a ser el grupo primario y no se creó ningún grupo con el nombre de la cuenta.

~]# useradd -g wheel bob
~]# id bob
uid=1002(bob) gid=10(wheel) groups=10(wheel)

Una cuenta creada con -M no tiene directorio personal, así que al entrar con su - apareció la advertencia [su: warning: cannot change directory to /home/tempuser: No such file or directory].

~]# 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

🔲 Cómo leer el resultado de useradd

useradd no muestra nada si tiene éxito, así que el resultado se comprueba en los archivos de información de cuentas. En /etc/group, devuser se añadió a la lista de miembros al final de la línea de wheel agregado con -G, y el grupo devuser, con el mismo nombre que la cuenta, tenía vacío el campo de miembros.

~]# grep -E '^(wheel|devuser):' /etc/group
wheel:x:10:linuxuser,devuser
devuser:x:1001:

En /etc/shadow, el segundo campo era [!!] antes de fijar la contraseña, y el tercer campo, 20771, es el número de días contados desde el 1 de enero de 1970, que corresponde al 14 de noviembre de 2026.

~]# grep '^devuser:' /etc/shadow | cut -d: -f1-3
devuser:!!:20771

useradd, passwd e id se pueden escribir directamente en el Simulador del comando useradd.

El período de uso de la contraseña y la fecha de caducidad de una cuenta creada así se fijan con el comando chage.

5️⃣ Valores predeterminados de useradd y /etc/login.defs

Al ejecutar useradd -D sin opciones se muestran los valores predeterminados guardados en /etc/default/useradd. Este es el resultado en el servidor AlmaLinux.

useradd -D
GROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yes

HOME, SHELL y SKEL son la ruta superior donde se crean los directorios personales, el shell predeterminado y el directorio con los archivos que se copian. GROUP=100 es el número del grupo predeterminado users, que se usa cuando no se crea un grupo con el mismo nombre que la cuenta. INACTIVE=-1 y el EXPIRE vacío indican que no se ha fijado ni la desactivación tras caducar la contraseña ni la fecha de caducidad de la cuenta.

Si se añade una opción como -s después de -D, en lugar de mostrar los valores predeterminados se cambian los de /etc/default/useradd. Para solo comprobarlos, se ejecuta -D sin nada más.

El rango de UID, los permisos del directorio personal y la forma de guardar las contraseñas se fijan en /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 indica que los nuevos directorios personales se crean con permisos que solo esa cuenta puede abrir, y ENCRYPT_METHOD SHA512 indica que las contraseñas fijadas con passwd se guardan como hash SHA-512. USERGROUPS_ENAB yes es la opción que crea un grupo con el mismo nombre para cada cuenta nueva.

El /etc/login.defs del servidor Debian 12 también tenía igual UID_MIN 1000 y ENCRYPT_METHOD SHA512, pero no tenía las líneas HOME_MODE ni CREATE_HOME. La salida de useradd -D en Debian incluía CREATE_MAIL_SPOOL=no, que no crea archivo de cola de correo.

6️⃣ Cómo usar el comando passwd

Con un nombre de cuenta, el comando passwd cambia la contraseña de esa cuenta; sin nombre, cambia la de la cuenta con la que se ha iniciado sesión. Solo root puede cambiar la contraseña de otra cuenta.

passwd user1
Changing password for user user1.
New password: 
Retype new password: 
passwd: all authentication tokens updated successfully.

La contraseña escrita no aparece en pantalla y solo se guarda si los dos valores introducidos coinciden. Si no coinciden, aparece [Sorry, passwords do not match.] y se vuelve a pedir la contraseña nueva. En el servidor AlmaLinux, la línea pam_pwquality que comprueba las contraseñas en la configuración de PAM tiene retry=3, así que la contraseña se pide hasta tres veces en total.

La longitud mínima predeterminada de pwquality es de 8 caracteres, así que una contraseña más corta recibe [BAD PASSWORD: The password is shorter than 8 characters]. En el servidor AlmaLinux 9.8, la línea enforce_for_root de pwquality.conf estaba comentada, pero el mismo valor estaba añadido a la línea de configuración de PAM. Por eso, incluso al introducir una contraseña corta como root, tras la advertencia se volvió a pedir la contraseña nueva y al final terminó con [Password change has been aborted.].

La razón por la que una cuenta normal puede cambiar su propia contraseña está en los permisos de dos archivos.

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 tiene vacíos todos los campos de permisos, así que solo root puede leerlo y escribirlo. /usr/bin/passwd tiene una s (setuid) en el campo del propietario, así que aunque lo ejecute una cuenta normal, funciona con privilegios de root y escribe la nueva contraseña en /etc/shadow.

7️⃣ Opciones de passwd y comprobación del estado

Las opciones de passwd varían porque cada distribución usa un programa distinto. En el servidor AlmaLinux, passwd estaba en un paquete passwd distinto 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

En el servidor Debian 12, useradd y passwd estaban los dos en el paquete passwd. Según passwd --help del servidor AlmaLinux 9.8, las opciones más usadas son las siguientes, y todas solo las puede usar root.

OpciónTarea
-S, --statusMuestra el estado de la contraseña en una línea
-l, --lockBloquea la contraseña añadiendo ! delante del hash
-u, --unlockDesbloquea la contraseña
-d, --deleteBorra la contraseña
-e, --expireHace caducar la contraseña al momento; se cambia en el siguiente inicio de sesión
-x, --maximumNúmero máximo de días de uso de la contraseña
-n, --minimumNúmero mínimo de días de uso de la contraseña
-w, --warningDías de aviso antes de la caducidad
-i, --inactiveDías desde la caducidad hasta que la cuenta se desactiva
--stdinRecibe la nueva contraseña por la entrada estándar

passwd --help del servidor Debian 12 no tenía --stdin, y tenía -a, que con -S muestra el estado de todas las cuentas.

-S muestra el estado de la contraseña en una línea.

passwd -S root
root PS 2026-01-15 0 99999 7 -1 (Password set, SHA512 crypt.)

Los campos son, por orden, el nombre de la cuenta, el estado, la fecha del último cambio de contraseña, los días mínimos, los días máximos, los días de aviso y los días de inactividad. El estado PS es una contraseña utilizable, LK una contraseña bloqueada y NP indica que no hay contraseña. Según el manual oficial, una cuenta creada por useradd tiene la contraseña desactivada, así que no puede iniciar sesión con contraseña hasta que se fije una con passwd.

En AlmaLinux, -S solo lo puede usar root. Cuando root tomó los privilegios de la cuenta nobody con runuser y lo ejecutó, terminó con [Only root can do that.].

runuser -u nobody -- passwd -S nobody
Only root can do that.

En el servidor Debian 12, una cuenta normal podía comprobar su propio estado. El campo de estado mostraba P en lugar de PS, y no había descripción entre paréntesis al final.

passwd -S
webuser P 2026-01-20 0 99999 7 -1

Al consultar el estado de root con la misma cuenta normal, se bloqueó con [You may not view or modify password information for root.].

Aunque la contraseña se bloquee con -l, según el manual oficial se puede seguir iniciando sesión con otra autenticación, como las claves SSH. Para bloquear toda la cuenta se usa [chage -E 0 nombre_de_cuenta].

🔢 FAQ & contenido recomendado

En el servidor AlmaLinux 9.8, /usr/sbin/adduser era un enlace a useradd, así que los dos comandos eran el mismo programa. En el servidor Debian 12, adduser es un programa aparte del paquete adduser, y el manual oficial lo describe como un programa que envuelve herramientas de nivel inferior como useradd y pregunta el campo de descripción y la contraseña.

useradd está en /usr/sbin. El /etc/login.defs del servidor Debian 12 no ponía /usr/sbin en el PATH de las cuentas normales, y al escribir [useradd -D] con una cuenta normal terminó con [command not found]. Hay que añadir [sudo] o ejecutarlo con la cuenta root.

El passwd de la familia RHEL, como AlmaLinux, tiene la opción --stdin, que recibe la nueva contraseña por la entrada estándar, y solo root puede usarla. El passwd del servidor Debian 12 no tenía esta opción. Los dos servidores tenían [chpasswd], que según el manual oficial recibe por la entrada estándar líneas con la forma [cuenta:contraseña] y fija de una vez las contraseñas de varias cuentas. Las contraseñas escritas directamente en la línea de comandos pueden quedar en el historial del shell.

ℹ️ Aviso de afiliados
El contenido de este sitio incluye enlaces de afiliado. Cuando un visitante compra un producto o servicio a través de uno de ellos, el sitio recibe una comisión del vendedor. El importe que paga el comprador(baja durante las promociones ↓)no aumenta. Los precios, descuentos y existencias publicados corresponden al momento de redacción y pueden variar, así que confírmalos con el vendedor antes de comprar. Los productos se eligen y evalúan con criterios propios, y las comisiones no influyen en el orden ni en el contenido de las reseñas.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Demuestra que eres humano: 0   +   8   =