useradd-Befehl: Optionen, Verwendung von -m und -s, Passwort setzen mit passwd
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 user1Laut 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 rootroot:x:0:0:root:/root:/bin/bashVon 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.defsCREATE_HOME yesAuf 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 -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/sh
SKEL=/etc/skel
CREATE_MAIL_SPOOL=no
LOG_INIT=yesAuf 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 user1Die Dateien, die ins Home-Verzeichnis kopiert werden, liegen in /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 .bashrcIn /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.
| Option | Kopieren | Beschreibung |
|---|---|---|
| -m, --create-home | Legt das Home-Verzeichnis an und kopiert die Dateien aus /etc/skel | |
| -M, --no-create-home | Legt kein Home-Verzeichnis an | |
| -s, --shell | Legt die Login-Shell fest | |
| -g, --gid | Legt die primäre Gruppe fest, nur bereits vorhandene Gruppen | |
| -G, --groups | Legt zusätzliche Gruppen fest, mehrere durch Kommas getrennt | |
| -c, --comment | Füllt das Beschreibungsfeld (GECOS) aus | |
| -D, --defaults | Gibt die Standardwerte aus; mit weiteren Optionen werden sie geändert |
| Option | Kopieren | Beschreibung |
|---|---|---|
| -d, --home-dir | Legt den Pfad des Home-Verzeichnisses fest | |
| -u, --uid | Legt die UID fest | |
| -e, --expiredate | Legt das Ablaufdatum des Kontos fest (YYYY-MM-DD) | |
| -f, --inactive | Anzahl der Tage nach Ablauf des Passworts, bis das Konto nicht mehr verwendet werden kann | |
| -r, --system | Legt ein Systemkonto an | |
| -N, --no-user-group | Legt keine Gruppe mit demselben Namen wie das Konto an | |
| -p, --password | Legt 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) ALLuseradd -G wheel user2Fragt 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.
4️⃣ Praxisbeispiele für den useradd-Befehl
🔲 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/bashDas 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/devuserEine 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 existBei 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/bshEin 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:!!:20771Zum 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 -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yesHOME, 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.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 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 user1Changing 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/shadowBei /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/passwdshadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64Auf 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.
| Option | Was es tut |
|---|---|
| -S, --status | Gibt den Passwortstatus in einer Zeile aus |
| -l, --lock | Sperrt das Passwort, setzt ! vor den Hash |
| -u, --unlock | Entsperrt das Passwort |
| -d, --delete | Löscht das Passwort |
| -e, --expire | Lässt das Passwort sofort ablaufen, Änderung bei der nächsten Anmeldung |
| -x, --maximum | Höchstzahl der Tage, die das Passwort verwendet werden kann |
| -n, --minimum | Mindestzahl der Tage, die das Passwort verwendet werden muss |
| -w, --warning | Tage der Warnung vor dem Ablauf |
| -i, --inactive | Tage nach dem Ablauf, bis das Konto deaktiviert wird |
| --stdin | Nimmt 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 rootroot 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 nobodyOnly 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 -Swebuser P 2026-01-20 0 99999 7 -1Die 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
Konto löschen
userdel-Befehl: Optionen, Home-Verzeichnis löschen mit -r und Fehler beim Löschen von Linux-Konten
Ein Beitrag darüber, wie man ein Konto mit userdel löscht und mit der Option -r auch Home-Verzeichnis und Mail-Datei entfernt.
ℹ️ 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.