useradd-Befehl: Optionen, Verwendung von -m und -s, Passwort setzen mit passwd

TestumgebungRHEL-FamilieAlmaLinux 9.8shadow-utils 4.9root-KontoDebian 12 normales Konto
Benutzer · GruppenuseraddpasswdSpeicherort/usr/sbin/useradd

Der useradd-Befehl fügt unter Linux ein neues Benutzerkonto hinzu, und der passwd-Befehl legt das Passwort dieses Kontos fest oder sperrt es. Beim Vergleich der useradd-Standardwerte und Konfigurationsdateien auf AlmaLinux-9- und Debian-12-Servern war AlmaLinux so eingestellt, dass es auch ohne Optionen ein Home-Verzeichnis anlegt und bash als Login-Shell setzt, während Debian keine Einstellung zum Anlegen eines Home-Verzeichnisses hatte und die Standard-Shell sh war.

Die Ausgabe unten stammt von einem AlmaLinux-9.8-Server mit dem root-Konto und von einem Debian-12-Server mit einem normalen Konto. Passwortänderungsdaten, Namen der Testkonten und die Versionsnummern der Pakete shadow-utils und passwd wurden durch Beispielwerte ersetzt.

1️⃣ Verwendung des useradd-Befehls

Die Grundform ist [useradd Optionen Kontoname]. Da der Befehl /etc/passwd und /etc/shadow ändert, in denen die Kontoinformationen stehen, wird er mit dem root-Konto oder mit sudo ausgeführt.

useradd user1

Laut der Tabelle der Exit-Codes im offiziellen Handbuch endet useradd bei Erfolg mit 0 und mit 9, wenn bereits ein Konto mit demselben Namen existiert. Das angelegte Konto wird mit id oder getent passwd geprüft; das Ausgabeformat von id sieht so aus.

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

Die UID eines neuen Kontos wird auf den nächsten Wert nach der höchsten bereits verwendeten Nummer ab UID_MIN 1000 in /etc/login.defs gesetzt. Eine Gruppe mit demselben Namen wie das Konto entsteht gleich mit.

Eine Zeile in /etc/passwd besteht aus sieben durch Doppelpunkte getrennten Feldern. Auf dem AlmaLinux-Server wurde die Zeile des root-Kontos abgefragt.

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

Von links sind das Kontoname, Passwortfeld, UID, GID, Beschreibung, Home-Verzeichnis und Login-Shell. Das x im Passwortfeld bedeutet, dass der eigentliche Passwort-Hash getrennt in /etc/shadow gespeichert ist.

2️⃣ Home-Verzeichnis anlegen mit useradd -m

Die Option -m legt unter /home ein Home-Verzeichnis mit dem Kontonamen an und kopiert die Dateien aus /etc/skel hinein. Ob auch ohne -m ein Home-Verzeichnis entsteht, bestimmt der Wert CREATE_HOME in /etc/login.defs.

grep CREATE_HOME /etc/login.defs
CREATE_HOME	yes

Auf dem AlmaLinux-9.8-Server ist CREATE_HOME auf yes gesetzt, daher entsteht /home/user1 schon mit useradd user1. In /etc/login.defs des Debian-12-Servers fand dasselbe grep keine einzige Zeile und endete mit Exit-Code 1. Das offizielle Handbuch schreibt, dass ohne aktiviertes CREATE_HOME kein Home-Verzeichnis ohne -m angelegt wird.

Auf einem Debian-12-Server sollte auch die Standard-Shell geprüft werden. Bei der Ausgabe der Standardwerte mit einem normalen Konto war SHELL /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

Auf dem Debian-12-Server war /bin/sh mit dash verknüpft. Damit sich ein neues Konto mit bash anmeldet, werden Home-Verzeichnis und Shell zusammen angegeben.

useradd -m -s /bin/bash user1

Die Dateien, die ins Home-Verzeichnis kopiert werden, liegen in /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

In /etc/skel des AlmaLinux-Servers lagen drei bash-Konfigurationsdateien, auf dem Debian-12-Server waren es .bash_logout, .bashrc und .profile. Sollen alle neuen Konten bestimmte Konfigurationsdateien erhalten, werden sie vorab in /etc/skel abgelegt; ein anderes Verzeichnis wird mit der Option -k angegeben.

Umgekehrt legt -M kein Home-Verzeichnis an, auch wenn CREATE_HOME auf yes steht.

3️⃣ Optionen von useradd

Die Liste der Optionen gibt useradd --help aus. Die häufig verwendeten Optionen in shadow-utils 4.9 auf dem AlmaLinux-9.8-Server sind folgende.

OptionKopierenBeschreibung
-m, --create-homeLegt das Home-Verzeichnis an und kopiert die Dateien aus /etc/skel
-M, --no-create-homeLegt kein Home-Verzeichnis an
-s, --shellLegt die Login-Shell fest
-g, --gidLegt die primäre Gruppe fest, nur bereits vorhandene Gruppen
-G, --groupsLegt zusätzliche Gruppen fest, mehrere durch Kommas getrennt
-c, --commentFüllt das Beschreibungsfeld (GECOS) aus
-D, --defaultsGibt die Standardwerte aus; mit weiteren Optionen werden sie geändert
OptionKopierenBeschreibung
-d, --home-dirLegt den Pfad des Home-Verzeichnisses fest
-u, --uidLegt die UID fest
-e, --expiredateLegt das Ablaufdatum des Kontos fest (YYYY-MM-DD)
-f, --inactiveAnzahl der Tage nach Ablauf des Passworts, bis das Konto nicht mehr verwendet werden kann
-r, --systemLegt ein Systemkonto an
-N, --no-user-groupLegt keine Gruppe mit demselben Namen wie das Konto an
-p, --passwordLegt ein verschlüsseltes Passwort fest

Mehrere Optionen können zusammen in einer Zeile stehen. Dieses Beispiel legt Pfad des Home-Verzeichnisses, Shell und Beschreibungsfeld auf einmal fest.

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

-G fügt Gruppen hinzu und lässt die primäre Gruppe unverändert. In /etc/sudoers des AlmaLinux-Servers stand eine Zeile, nach der die Gruppe wheel alle Befehle ausführen darf. Ein Konto in der Gruppe wheel kann daher mit sudo Befehle mit root-Rechten ausführen.

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

Fragt man ein so angelegtes Konto mit id ab, erscheint im Feld groups zusätzlich 10(wheel).

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

-r legt ein Systemkonto an, das von Dienstprogrammen genutzt wird. Die UID wird zwischen SYS_UID_MIN 201 und SYS_UID_MAX 999 in /etc/login.defs vergeben. Laut offiziellem Handbuch bekommt ein mit -r angelegtes Konto auch bei CREATE_HOME yes kein Home-Verzeichnis, und ein Konto, das sich nie anmelden muss, erhält /sbin/nologin als Shell.

useradd -r -s /sbin/nologin svc1

-p ist die Option, die einen verschlüsselten Passwortwert entgegennimmt. Das offizielle Handbuch rät davon ab, weil der Wert für Benutzer sichtbar werden kann, die die Prozessliste ansehen; das Passwort wird daher nach dem Anlegen des Kontos mit passwd gesetzt.

🔲 Simulator für den useradd-Befehl

Im Simulator unten lässt sich der Ablauf selbst eintippen: mit useradd ein Konto anlegen, mit passwd das Passwort setzen und mit id und getent prüfen.

Simulator für den useradd-Befehlshadow-utils 4.9
[root@server work]#
Ein virtueller AlmaLinux-Server, der nur im Browser läuft; angelegte Konten erscheinen in der Tabelle links und im /home-Baum, und mit ↑↓ werden zuvor eingegebene Befehle wieder aufgerufen.

4️⃣ Praxisbeispiele für den useradd-Befehl

  • ↪️ Ein Entwicklungskonto anlegen und häufige Anfängerfehler

🔲 Ein Entwicklungskonto anlegen

Ein Konto für einen Entwickler wurde in einer Zeile angelegt, mit Home-Verzeichnis, bash-Shell, Beschreibungsfeld und der Gruppe wheel. useradd endete ohne Ausgabe, und die angegebenen Werte waren in der Ausgabe von id und in der Zeile von /etc/passwd genau so zu sehen.

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

Das Home-Verzeichnis wurde mit den Rechten drwx------ angelegt, die nur dieses Konto öffnen kann, und die drei bash-Konfigurationsdateien aus /etc/skel wurden hineinkopiert. Da der Server CREATE_MAIL_SPOOL=yes hat, entstand auch eine Mail-Spool-Datei der Größe 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

Eine Abfrage mit passwd -S direkt nach dem Anlegen des Kontos zeigte den Status LK.

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

Nachdem das Passwort mit passwd devuser zweimal eingegeben und gesetzt war, zeigte die erneute Abfrage den Status PS.

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

🔲 Häufige Anfängerfehler

Wurde hinter -G eine noch nicht vorhandene Gruppe angegeben, endete der Befehl mit Exit-Code 6, ohne das Konto anzulegen. Gruppen, die mit -G hinzugefügt werden, müssen vorher angelegt sein.

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

Bei einem falsch geschriebenen Shell-Pfad erschien nur eine Warnzeile, und das Konto wurde trotzdem angelegt. Im letzten Feld von /etc/passwd stand der nicht vorhandene Pfad /bin/bsh, deshalb wird dieses Feld nach dem Anlegen des Kontos noch einmal geprüft.

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

Ein weiterer Fehler ist das Verwechseln von kleinem -g und großem -G. Als das vorige bob mit userdel -r gelöscht und mit -g wheel neu angelegt wurde, wurde wheel zur primären Gruppe, und eine Gruppe mit dem Kontonamen entstand nicht.

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

Ein mit -M angelegtes Konto hat kein Home-Verzeichnis, daher erschien beim Wechsel mit su - die Warnung [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

🔲 Das Ergebnis von useradd lesen

useradd gibt bei Erfolg nichts aus, daher wird das Ergebnis in den Dateien mit den Kontoinformationen geprüft. In /etc/group wurde devuser an die Mitgliederliste am Ende der mit -G hinzugefügten wheel-Zeile angehängt, und die Gruppe devuser mit demselben Namen wie das Konto hatte ein leeres Mitgliederfeld.

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

In /etc/shadow war das zweite Feld vor dem Setzen des Passworts [!!], und das dritte Feld 20771 ist die Zahl der Tage ab dem 1. Januar 1970, also der 14. November 2026.

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

Zum direkten Ausprobieren von useradd, passwd und id dient der Simulator für den useradd-Befehl.

Gültigkeitsdauer des Passworts und Ablaufdatum eines so angelegten Kontos legt man fest mit dem chage-Befehl.

5️⃣ Standardwerte von useradd und /etc/login.defs

useradd -D ohne Optionen gibt die in /etc/default/useradd gespeicherten Standardwerte aus. Das ist das Ergebnis auf dem AlmaLinux-Server.

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

HOME, SHELL und SKEL sind der übergeordnete Pfad, unter dem Home-Verzeichnisse angelegt werden, die Standard-Shell und das Verzeichnis mit den zu kopierenden Dateien. GROUP=100 ist die Nummer der Standardgruppe users, die verwendet wird, wenn keine Gruppe mit dem Kontonamen angelegt wird. INACTIVE=-1 und das leere EXPIRE bedeuten, dass weder eine Deaktivierung nach Passwortablauf noch ein Ablaufdatum des Kontos festgelegt ist.

Steht hinter -D eine Option wie -s, werden statt der Ausgabe der Standardwerte die Werte in /etc/default/useradd geändert. Um die Standardwerte nur zu prüfen, wird -D allein ausgeführt.

UID-Bereich, Rechte des Home-Verzeichnisses und Speicherverfahren für Passwörter werden in /etc/login.defs festgelegt.

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 bedeutet, dass neue Home-Verzeichnisse mit Rechten angelegt werden, die nur dieses Konto öffnen kann, und ENCRYPT_METHOD SHA512 bedeutet, dass mit passwd gesetzte Passwörter als SHA-512-Hash gespeichert werden. USERGROUPS_ENAB yes ist die Einstellung, die für jedes neue Konto eine gleichnamige Gruppe anlegt.

Auch /etc/login.defs des Debian-12-Servers hatte dieselben Werte UID_MIN 1000 und ENCRYPT_METHOD SHA512, aber keine Zeilen HOME_MODE und CREATE_HOME. Die Ausgabe von useradd -D unter Debian enthielt CREATE_MAIL_SPOOL=no, das keine Mail-Spool-Datei anlegt.

6️⃣ Verwendung des passwd-Befehls

Mit einem Kontonamen ändert der passwd-Befehl das Passwort dieses Kontos, ohne Namen das Passwort des gerade angemeldeten Kontos. Das Passwort eines anderen Kontos kann nur root ändern.

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

Das eingegebene Passwort erscheint nicht auf dem Bildschirm und wird nur gespeichert, wenn beide Eingaben übereinstimmen. Weichen sie ab, erscheint [Sorry, passwords do not match.], und das neue Passwort wird erneut abgefragt. In der PAM-Konfiguration des AlmaLinux-Servers hat die Zeile pam_pwquality, die Passwörter prüft, retry=3, daher wird das Passwort insgesamt bis zu dreimal abgefragt.

Die Standard-Mindestlänge von pwquality beträgt 8 Zeichen, daher erhält ein kürzeres Passwort [BAD PASSWORD: The password is shorter than 8 characters]. Auf dem AlmaLinux-9.8-Server war die Zeile enforce_for_root in pwquality.conf auskommentiert, aber derselbe Wert hing an der Zeile der PAM-Konfiguration. Deshalb wurde auch bei einem kurzen Passwort als root nach der Warnung erneut nach dem neuen Passwort gefragt, und am Ende stand [Password change has been aborted.].

Dass ein normales Konto sein eigenes Passwort ändern kann, liegt an den Rechten zweier Dateien.

stat -c "%A %U %G %n" /usr/bin/passwd /etc/shadow
-rwsr-xr-x root root /usr/bin/passwd
---------- root root /etc/shadow

Bei /etc/shadow sind alle Rechtefelder leer, daher kann nur root die Datei lesen und schreiben. /usr/bin/passwd hat im Eigentümerfeld ein s (setuid), daher läuft es auch beim Aufruf durch ein normales Konto mit root-Rechten und schreibt das neue Passwort in /etc/shadow.

7️⃣ Optionen von passwd und Status prüfen

Die Optionen von passwd unterscheiden sich, weil jede Distribution ein anderes Programm mitliefert. Auf dem AlmaLinux-Server lag passwd in einem von shadow-utils getrennten passwd-Paket.

rpm -qf /usr/sbin/useradd /usr/bin/passwd
shadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64

Auf dem Debian-12-Server lagen useradd und passwd beide im Paket passwd. Laut passwd --help auf dem AlmaLinux-9.8-Server sind die häufig verwendeten Optionen folgende, und alle sind nur für root nutzbar.

OptionWas es tut
-S, --statusGibt den Passwortstatus in einer Zeile aus
-l, --lockSperrt das Passwort, setzt ! vor den Hash
-u, --unlockEntsperrt das Passwort
-d, --deleteLöscht das Passwort
-e, --expireLässt das Passwort sofort ablaufen, Änderung bei der nächsten Anmeldung
-x, --maximumHöchstzahl der Tage, die das Passwort verwendet werden kann
-n, --minimumMindestzahl der Tage, die das Passwort verwendet werden muss
-w, --warningTage der Warnung vor dem Ablauf
-i, --inactiveTage nach dem Ablauf, bis das Konto deaktiviert wird
--stdinNimmt das neue Passwort über die Standardeingabe entgegen

passwd --help auf dem Debian-12-Server hatte kein --stdin, dafür -a, das zusammen mit -S den Status aller Konten ausgibt.

-S gibt den Passwortstatus in einer Zeile aus.

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

Die Felder sind der Reihe nach Kontoname, Status, Datum der letzten Passwortänderung, Mindesttage, Höchsttage, Warntage und Inaktivitätstage. Der Status PS ist ein nutzbares Passwort, LK ein gesperrtes Passwort und NP bedeutet, dass kein Passwort vorhanden ist. Laut offiziellem Handbuch ist das Passwort eines mit useradd angelegten Kontos deaktiviert, daher ist eine Anmeldung mit Passwort erst möglich, wenn eines mit passwd gesetzt wurde.

Unter AlmaLinux kann nur root -S verwenden. Als root mit runuser die Rechte des Kontos nobody übernahm und den Befehl ausführte, endete er mit [Only root can do that.].

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

Auf dem Debian-12-Server konnte ein normales Konto seinen eigenen Status prüfen. Das Statusfeld zeigte P statt PS, und die Erklärung in Klammern am Ende fehlte.

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

Die Abfrage des root-Status mit demselben normalen Konto wurde mit [You may not view or modify password information for root.] blockiert.

Auch wenn das Passwort mit -l gesperrt ist, ist laut offiziellem Handbuch eine Anmeldung über andere Authentifizierung wie SSH-Schlüssel weiter möglich. Um das ganze Konto zu sperren, wird [chage -E 0 Kontoname] verwendet.

🔢 FAQ & empfohlene Inhalte

Auf dem AlmaLinux-9.8-Server war /usr/sbin/adduser ein Link auf useradd, beide Befehle waren also dasselbe Programm. Auf dem Debian-12-Server ist adduser ein eigenes Programm aus dem Paket adduser, und das offizielle Handbuch beschreibt es als Programm, das niedrigere Werkzeuge wie useradd umhüllt und nach Beschreibungsfeld und Passwort fragt.

useradd liegt in /usr/sbin. /etc/login.defs des Debian-12-Servers nahm /usr/sbin nicht in den PATH normaler Konten auf, und [useradd -D] mit einem normalen Konto endete mit [command not found]. Mit vorangestelltem [sudo] oder mit dem root-Konto ausführen.

passwd auf Systemen der RHEL-Familie wie AlmaLinux hat die Option --stdin, die das neue Passwort über die Standardeingabe entgegennimmt; nur root kann sie verwenden. passwd auf dem Debian-12-Server hatte diese Option nicht. Auf beiden Servern war [chpasswd] vorhanden, das laut offiziellem Handbuch Zeilen der Form [Konto:Passwort] über die Standardeingabe entgegennimmt und die Passwörter mehrerer Konten auf einmal setzt. Direkt in der Befehlszeile geschriebene Passwörter können im Shell-Verlauf bleiben.

ℹ️ Affiliate-Hinweis
Die Inhalte dieser Website enthalten Affiliate-Links. Kauft ein Besucher über einen dieser Links ein Produkt oder eine Dienstleistung, erhält die Website vom Verkäufer eine Provision. Der Betrag, den der Käufer zahlt(bei Aktionsrabatten sinkt er ↓), steigt dadurch nicht. Angegebene Preise, Rabatte und Lagerbestände entsprechen dem Stand bei Erstellung und können abweichen; prüfe sie daher vor dem Kauf beim Verkäufer. Produkte werden nach eigenen Kriterien ausgewählt und bewertet, und Provisionen beeinflussen weder die Reihenfolge noch den Inhalt der Bewertungen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Beweisen Sie, dass Sie ein Mensch sind: 6   +   5   =