useradd¶
Legt einen neuen Benutzer mit einem einzigen Befehl ohne Rückfragen an, das Low-Level-Werkzeug, das auf jeder Distribution gleich funktioniert.

Syntax¶
useradd [OPTION]... BENUTZER
Optionen¶
| Option | Beschreibung |
|---|---|
-m, --create-home |
Home-Verzeichnis anlegen und /etc/skel kopieren |
-s SHELL, --shell |
Login-Shell, z. B. /bin/bash |
-c TEXT, --comment |
Vollständiger Name oder Beschreibung |
-G GRUPPEN, --groups |
Zusätzliche Gruppen, durch Kommas getrennt |
-g GRUPPE, --gid |
Primäre Gruppe (statt einer neuen Gruppe mit dem Benutzernamen) |
-d VERZ, --home-dir |
Home-Verzeichnis |
-u UID, --uid |
Diese UID verwenden |
-r, --system |
Einen Systembenutzer anlegen (UID unter 1000, kein Home-Verzeichnis) |
-e DATUM, --expiredate |
Datum, an dem das Konto abläuft (JJJJ-MM-TT) |
-D, --defaults |
Die Standardwerte anzeigen |
Beispiele¶
Einen normalen Benutzer mit Home-Verzeichnis und Bash anlegen:
sudo useradd -m -s /bin/bash -c "Bob Example" bob
getent passwd bob
bob:x:1003:1003:Bob Example:/home/bob:/bin/bash
Was ohne -m und -s passiert:
sudo useradd carol
getent passwd carol
ls -d /home/carol
carol:x:1004:1004::/home/carol:/bin/sh
ls: cannot access '/home/carol': No such file or directory
Unter Debian und Ubuntu legt useradd standardmäßig kein Home-Verzeichnis an und nutzt
/bin/sh als Shell.
Einen Benutzer mit zusätzlichen Gruppen anlegen:
sudo useradd -m -s /bin/bash -G sudo,docker dave
groups dave
dave : dave sudo docker
Einen Systembenutzer für einen Dienst anlegen:
sudo useradd -r -s /usr/sbin/nologin -d /opt/myapp myapp
getent passwd myapp
myapp:x:997:997::/opt/myapp:/usr/sbin/nologin
Versuchen, einen Benutzer anzulegen, der schon existiert:
sudo useradd bob
useradd: user 'bob' already exists
Wann brauche ich das?¶
- In Skripten, Ansible-Rollen oder Dockerfiles, weil
useraddnie nachfragt - Auf Distributionen, auf denen
adduserfehlt oder anders funktioniert, etwa Arch, RHEL (dort istaddusernur ein anderer Name füruseradd) oder Alpine - Um Systembenutzer für Dienste mit genauer UID, Home-Verzeichnis und Shell anzulegen
Danach ein Passwort setzen
useradd setzt kein Passwort, der Benutzer kann sich also noch nicht mit einem
Passwort anmelden. Setze es mit sudo passwd bob, oder hinterlege einen SSH-Schlüssel
in ~/.ssh/authorized_keys.
Für normale Benutzer immer -m
Ohne -m hat der Benutzer kein Home-Verzeichnis. Anmeldungen landen dann mit einer
Warnung in /, und Programme können keine Einstellungen speichern.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
Home-Verzeichnis ohne -m |
wird nicht angelegt | wird nicht angelegt | wird angelegt | wird nicht angelegt |
Standard-Shell (useradd -D) |
/bin/sh |
/bin/sh |
/bin/bash |
/bin/bash |
| Admin-Gruppe | sudo |
sudo |
wheel |
wheel |
| Empfohlenes Werkzeug | adduser |
adduser |
useradd |
useradd |