Comando useradd: opções, uso de -m e -s e senha com passwd

Ambiente de testeFamília RHELAlmaLinux 9.8shadow-utils 4.9conta rootDebian 12 conta comum
Usuários · gruposuseraddpasswdLocalização/usr/sbin/useradd

O comando useradd adiciona uma nova conta de usuário no Linux, e o comando passwd define ou bloqueia a senha dessa conta. Ao comparar os valores padrão do useradd e os arquivos de configuração em servidores AlmaLinux 9 e Debian 12, o AlmaLinux estava configurado para criar o diretório home e usar o bash como shell de login mesmo sem opções, enquanto o Debian não tinha configuração para criar o diretório home e seu shell padrão era o sh.

A saída abaixo foi obtida em um servidor AlmaLinux 9.8 com a conta root e em um servidor Debian 12 com uma conta comum. As datas de troca de senha, os nomes das contas de teste e os números de versão dos pacotes shadow-utils e passwd foram trocados por valores de exemplo.

1️⃣ Como usar o comando useradd

A forma básica é [useradd opções nome_da_conta]. Como ele modifica /etc/passwd e /etc/shadow, que guardam as informações das contas, é executado com a conta root ou com sudo.

useradd user1

Segundo a tabela de códigos de saída do manual oficial, o useradd termina com 0 em caso de sucesso e com 9 quando já existe uma conta com o mesmo nome. A conta criada é verificada com id ou getent passwd, e o formato de saída do id é o seguinte.

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

O UID de uma conta nova é definido como o valor seguinte ao maior número já em uso, a partir de UID_MIN 1000 em /etc/login.defs. Um grupo com o mesmo nome da conta também é criado.

Uma linha de /etc/passwd tem sete campos separados por dois-pontos. A linha da conta root foi consultada no servidor AlmaLinux.

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

Da esquerda para a direita, são o nome da conta, o campo de senha, o UID, o GID, a descrição, o diretório home e o shell de login. O x no campo de senha indica que o hash real da senha fica guardado à parte em /etc/shadow.

2️⃣ Criar o diretório home com useradd -m

A opção -m cria em /home um diretório home com o nome da conta e copia para ele os arquivos de /etc/skel. Se o diretório home é criado mesmo sem -m depende do valor de CREATE_HOME em /etc/login.defs.

grep CREATE_HOME /etc/login.defs
CREATE_HOME	yes

No servidor AlmaLinux 9.8, CREATE_HOME é yes, então basta digitar useradd user1 para criar /home/user1. No /etc/login.defs do servidor Debian 12, o mesmo grep não encontrou nenhuma linha e terminou com o código de saída 1. O manual oficial diz que, se CREATE_HOME não estiver ativado, o diretório home não é criado sem -m.

Em um servidor Debian 12, é preciso verificar também o shell padrão. Ao exibir os valores padrão com uma conta comum, 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

No servidor Debian 12, /bin/sh estava ligado ao dash. Para que uma conta nova faça login com bash, informe juntos o diretório home e o shell.

useradd -m -s /bin/bash user1

Os arquivos copiados para o diretório home ficam em /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

O /etc/skel do servidor AlmaLinux continha três arquivos de configuração do bash, e o servidor Debian 12 tinha .bash_logout, .bashrc e .profile. Se houver arquivos de configuração que toda conta nova deve receber, coloque-os antes em /etc/skel; para usar outro diretório, informe-o com a opção -k.

Ao contrário, com -M o diretório home não é criado mesmo que CREATE_HOME seja yes.

3️⃣ Opções do useradd

A lista de opções é exibida com useradd --help. As opções mais usadas no shadow-utils 4.9 do servidor AlmaLinux 9.8 são as seguintes.

OpçãoCopiarDescrição
-m, --create-homeCria o diretório home e copia os arquivos de /etc/skel
-M, --no-create-homeNão cria o diretório home
-s, --shellDefine o shell de login
-g, --gidDefine o grupo primário; apenas grupos existentes
-G, --groupsDefine grupos suplementares, separados por vírgula quando há vários
-c, --commentPreenche o campo de descrição (GECOS)
-D, --defaultsMostra os valores padrão; com opções, altera os valores padrão
OpçãoCopiarDescrição
-d, --home-dirDefine o caminho do diretório home
-u, --uidDefine o UID
-e, --expiredateDefine a data de expiração da conta (YYYY-MM-DD)
-f, --inactiveNúmero de dias após a expiração da senha até a conta não poder mais ser usada
-r, --systemCria uma conta de sistema
-N, --no-user-groupNão cria um grupo com o mesmo nome da conta
-p, --passwordDefine uma senha criptografada

Várias opções podem ser escritas juntas em uma linha. Este exemplo define de uma vez o caminho do diretório home, o shell e o campo de descrição.

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

-G adiciona grupos e mantém o grupo primário como está. O /etc/sudoers do servidor AlmaLinux tinha uma linha que permite ao grupo wheel executar todos os comandos. Por isso, uma conta colocada no grupo wheel pode executar comandos com privilégios de root pelo sudo.

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

Consultando com id uma conta criada assim, o campo groups aparece com 10(wheel) acrescentado.

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

-r cria uma conta de sistema usada por programas de serviço. O UID é escolhido entre SYS_UID_MIN 201 e SYS_UID_MAX 999 de /etc/login.defs. Segundo o manual oficial, uma conta -r não recebe diretório home mesmo que CREATE_HOME seja yes, e uma conta que nunca precisa fazer login recebe /sbin/nologin como shell.

useradd -r -s /sbin/nologin svc1

-p é a opção que recebe o valor de uma senha criptografada. O manual oficial não a recomenda porque o valor pode ficar visível para usuários que olham a lista de processos; por isso, defina a senha com passwd depois de criar a conta.

🔲 Simulador do comando useradd

No simulador abaixo, você pode digitar por conta própria as etapas: criar uma conta com useradd, definir a senha com passwd e conferir com id e getent.

Simulador do comando useraddshadow-utils 4.9
[root@server work]#
É um servidor AlmaLinux virtual que funciona só dentro do navegador; as contas criadas aparecem na tabela à esquerda e na árvore /home, e ↑↓ recupera os comandos digitados antes.

4️⃣ Exemplos práticos do comando useradd

  • ↪️ Criar uma conta de desenvolvimento e erros comuns no começo

🔲 Criar uma conta de desenvolvimento

Uma conta para um desenvolvedor foi criada em uma linha, com diretório home, shell bash, campo de descrição e grupo wheel. O useradd terminou sem mostrar nada, e os valores informados apareciam exatamente assim na saída do id e na linha 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

O diretório home foi criado com permissões drwx------, que só essa conta pode abrir, e os três arquivos de configuração do bash de /etc/skel foram copiados. Como o servidor tem CREATE_MAIL_SPOOL=yes, também foi criado um arquivo de spool de e-mail de tamanho 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

Logo depois de criar a conta, a consulta com passwd -S mostrou o status LK.

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

Depois de definir a senha digitando-a duas vezes com passwd devuser, a nova consulta mostrou o status alterado para PS.

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

🔲 Erros comuns no começo

Ao escrever depois de -G um grupo que ainda não existia, a conta não foi criada e o comando terminou com o código de saída 6. Os grupos adicionados com -G precisam ser criados antes.

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

Quando o caminho do shell foi escrito errado, apareceu só uma linha de aviso e a conta foi criada mesmo assim. O caminho inexistente /bin/bsh ficou registrado no último campo de /etc/passwd, então é preciso conferir esse campo de novo depois de criar a conta.

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

Outro erro é trocar o -g minúsculo pelo -G maiúsculo. Ao excluir o bob anterior com userdel -r e criá-lo de novo com -g wheel, o wheel virou o grupo primário, sem grupo com o nome da conta.

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

Uma conta criada com -M não tem diretório home, então ao entrar com su - apareceu o aviso [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

🔲 Como ler o resultado do useradd

O useradd não mostra nada em caso de sucesso, então o resultado é conferido nos arquivos de informações das contas. Em /etc/group, devuser foi acrescentado à lista de membros no fim da linha do wheel adicionado com -G, e o grupo devuser, com o mesmo nome da conta, tinha o campo de membros vazio.

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

Em /etc/shadow, o segundo campo era [!!] antes de definir a senha, e o terceiro campo, 20771, é o número de dias contados desde 1 de janeiro de 1970, o que corresponde a 14 de novembro de 2026.

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

useradd, passwd e id podem ser digitados diretamente no Simulador do comando useradd.

O período de uso da senha e a data de expiração de uma conta criada assim são definidos com o comando chage.

5️⃣ Valores padrão do useradd e /etc/login.defs

Executar useradd -D sem opções mostra os valores padrão guardados em /etc/default/useradd. Este é o resultado no servidor AlmaLinux.

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

HOME, SHELL e SKEL são o caminho superior onde os diretórios home são criados, o shell padrão e o diretório com os arquivos a copiar. GROUP=100 é o número do grupo padrão users, usado quando não se cria um grupo com o mesmo nome da conta. INACTIVE=-1 e o EXPIRE vazio indicam que não foram definidos nem a desativação após a expiração da senha nem a data de expiração da conta.

Com uma opção como -s depois de -D, em vez de mostrar os valores padrão, os valores de /etc/default/useradd são alterados. Para apenas conferir os valores padrão, execute -D sozinho.

A faixa de UID, as permissões do diretório home e a forma de guardar as senhas são definidas em /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 os novos diretórios home são criados com permissões que só essa conta pode abrir, e ENCRYPT_METHOD SHA512 indica que as senhas definidas com passwd são guardadas como hash SHA-512. USERGROUPS_ENAB yes é a configuração que cria um grupo com o mesmo nome para cada conta nova.

O /etc/login.defs do servidor Debian 12 também tinha os mesmos UID_MIN 1000 e ENCRYPT_METHOD SHA512, mas não tinha as linhas HOME_MODE e CREATE_HOME. A saída do useradd -D no Debian incluía CREATE_MAIL_SPOOL=no, que não cria arquivo de spool de e-mail.

6️⃣ Como usar o comando passwd

Com um nome de conta, o comando passwd troca a senha dessa conta; sem nome, troca a senha da conta que está conectada. Só o root pode trocar a senha de outra conta.

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

A senha digitada não aparece na tela e só é salva quando os dois valores digitados são iguais. Se forem diferentes, aparece [Sorry, passwords do not match.] e a nova senha é pedida de novo. No servidor AlmaLinux, a linha pam_pwquality que verifica as senhas na configuração do PAM tem retry=3, então a senha é pedida até três vezes no total.

O comprimento mínimo padrão do pwquality é de 8 caracteres, então uma senha mais curta recebe [BAD PASSWORD: The password is shorter than 8 characters]. No servidor AlmaLinux 9.8, a linha enforce_for_root do pwquality.conf estava comentada, mas o mesmo valor estava na linha de configuração do PAM. Por isso, mesmo ao digitar uma senha curta como root, a nova senha foi pedida de novo depois do aviso e, no fim, terminou com [Password change has been aborted.].

O motivo de uma conta comum poder trocar a própria senha está nas permissões de dois arquivos.

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 tem todos os campos de permissão vazios, então só o root pode lê-lo e gravá-lo. /usr/bin/passwd tem um s (setuid) no campo do dono, então mesmo executado por uma conta comum ele funciona com privilégios de root e grava a nova senha em /etc/shadow.

7️⃣ Opções do passwd e verificação do status

As opções do passwd variam porque cada distribuição traz um programa diferente. No servidor AlmaLinux, o passwd estava em um pacote passwd separado do 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

No servidor Debian 12, useradd e passwd estavam os dois no pacote passwd. Com base no passwd --help do servidor AlmaLinux 9.8, as opções mais usadas são as seguintes, e todas só podem ser usadas pelo root.

OpçãoTarefa
-S, --statusMostra o status da senha em uma linha
-l, --lockBloqueia a senha, acrescentando ! antes do hash
-u, --unlockDesbloqueia a senha
-d, --deleteExclui a senha
-e, --expireExpira a senha na hora; troca no próximo login
-x, --maximumNúmero máximo de dias de uso da senha
-n, --minimumNúmero mínimo de dias de uso da senha
-w, --warningDias de aviso antes da expiração
-i, --inactiveDias após a expiração até a conta ser desativada
--stdinRecebe a nova senha pela entrada padrão

O passwd --help do servidor Debian 12 não tinha --stdin, mas tinha -a, que junto com -S mostra o status de todas as contas.

-S mostra o status da senha em uma linha.

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

Os campos são, em ordem, o nome da conta, o status, a data da última troca de senha, os dias mínimos, os dias máximos, os dias de aviso e os dias de inatividade. O status PS é uma senha utilizável, LK é uma senha bloqueada e NP indica que não há senha. Segundo o manual oficial, uma conta criada pelo useradd tem a senha desativada, então não consegue fazer login com senha até que uma seja definida com passwd.

No AlmaLinux, só o root pode usar -S. Quando o root pegou emprestados os privilégios da conta nobody com runuser e executou o comando, ele terminou com [Only root can do that.].

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

No servidor Debian 12, uma conta comum podia verificar o próprio status. O campo de status mostrava P em vez de PS, e não havia a explicação entre parênteses no fim.

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

Ao consultar o status do root com a mesma conta comum, o acesso foi bloqueado com [You may not view or modify password information for root.].

Mesmo com a senha bloqueada por -l, segundo o manual oficial, ainda é possível fazer login com outra autenticação, como chaves SSH. Para bloquear a conta inteira, use [chage -E 0 nome_da_conta].

🔢 FAQ & conteúdo recomendado

No servidor AlmaLinux 9.8, /usr/sbin/adduser era um link para o useradd, então os dois comandos eram o mesmo programa. No servidor Debian 12, o adduser é um programa separado do pacote adduser, e o manual oficial o descreve como um programa que envolve ferramentas de nível mais baixo como o useradd e pergunta o campo de descrição e a senha.

O useradd fica em /usr/sbin. O /etc/login.defs do servidor Debian 12 não colocava /usr/sbin no PATH das contas comuns, e digitar [useradd -D] com uma conta comum terminou com [command not found]. Acrescente [sudo] ou execute com a conta root.

O passwd da família RHEL, como o AlmaLinux, tem a opção --stdin, que recebe a nova senha pela entrada padrão, e só o root pode usá-la. O passwd do servidor Debian 12 não tinha essa opção. Os dois servidores tinham [chpasswd], que, segundo o manual oficial, recebe pela entrada padrão linhas no formato [conta:senha] e define de uma vez as senhas de várias contas. Senhas digitadas diretamente na linha de comando podem ficar no histórico do shell.

ℹ️ Aviso de afiliados
O conteúdo deste site contém links de afiliados. Quando um visitante compra um produto ou serviço por meio de um desses links, o site recebe uma comissão do vendedor. O valor que o comprador paga (em promoções, ele diminui ↓) não aumenta por causa disso. Preços, descontos e informações de estoque valem para o momento em que o texto foi escrito e podem ter mudado, por isso confirme com o vendedor antes de comprar. Os produtos são escolhidos e avaliados por critérios próprios, e o recebimento de comissão não influencia a ordem de apresentação nem o conteúdo das avaliações.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Demonstre sua humanidade: 6   +   2   =