Comando useradd: opciones, uso de -m y -s y contraseñas con passwd
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 user1Segú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 rootroot:x:0:0:root:/root:/bin/bashDe 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.defsCREATE_HOME yesEn 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 -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/sh
SKEL=/etc/skel
CREATE_MAIL_SPOOL=no
LOG_INIT=yesEn 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 user1Los archivos que se copian al directorio personal están en /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 .bashrcEl /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ón | Copiar | Descripción |
|---|---|---|
| -m, --create-home | Crea el directorio personal y copia los archivos de /etc/skel | |
| -M, --no-create-home | No crea el directorio personal | |
| -s, --shell | Indica el shell de inicio de sesión | |
| -g, --gid | Indica el grupo primario; solo grupos que ya existen | |
| -G, --groups | Indica grupos suplementarios, separados por comas si son varios | |
| -c, --comment | Rellena el campo de descripción (GECOS) | |
| -D, --defaults | Muestra los valores predeterminados; con opciones, los cambia |
| Opción | Copiar | Descripción |
|---|---|---|
| -d, --home-dir | Indica la ruta del directorio personal | |
| -u, --uid | Indica el UID | |
| -e, --expiredate | Indica la fecha de caducidad de la cuenta (YYYY-MM-DD) | |
| -f, --inactive | Número de días desde que caduca la contraseña hasta que la cuenta deja de poder usarse | |
| -r, --system | Crea una cuenta del sistema | |
| -N, --no-user-group | No crea un grupo con el mismo nombre que la cuenta | |
| -p, --password | Indica 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) ALLuseradd -G wheel user2Si 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.
4️⃣ Ejemplos prácticos del comando useradd
🔲 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/bashEl 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/devuserAl 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 existCuando 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/bshOtro 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:!!:20771useradd, 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 -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yesHOME, 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.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 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 user1Changing 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/passwdshadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64En 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ón | Tarea |
|---|---|
| -S, --status | Muestra el estado de la contraseña en una línea |
| -l, --lock | Bloquea la contraseña añadiendo ! delante del hash |
| -u, --unlock | Desbloquea la contraseña |
| -d, --delete | Borra la contraseña |
| -e, --expire | Hace caducar la contraseña al momento; se cambia en el siguiente inicio de sesión |
| -x, --maximum | Número máximo de días de uso de la contraseña |
| -n, --minimum | Número mínimo de días de uso de la contraseña |
| -w, --warning | Días de aviso antes de la caducidad |
| -i, --inactive | Días desde la caducidad hasta que la cuenta se desactiva |
| --stdin | Recibe 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 rootroot 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 nobodyOnly 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 -Swebuser P 2026-01-20 0 99999 7 -1Al 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
Borrar cuentas
Comando userdel: opciones, borrado del directorio personal con -r y errores al borrar cuentas en Linux
Un artículo sobre cómo borrar una cuenta con userdel y eliminar también su directorio personal y su archivo de correo con la opción -r.
ℹ️ 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.