Comando useradd: opções, uso de -m e -s e senha com passwd
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 user1Segundo 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 rootroot:x:0:0:root:/root:/bin/bashDa 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.defsCREATE_HOME yesNo 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 -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/sh
SKEL=/etc/skel
CREATE_MAIL_SPOOL=no
LOG_INIT=yesNo 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 user1Os arquivos copiados para o diretório home ficam em /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 .bashrcO /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ção | Copiar | Descrição |
|---|---|---|
| -m, --create-home | Cria o diretório home e copia os arquivos de /etc/skel | |
| -M, --no-create-home | Não cria o diretório home | |
| -s, --shell | Define o shell de login | |
| -g, --gid | Define o grupo primário; apenas grupos existentes | |
| -G, --groups | Define grupos suplementares, separados por vírgula quando há vários | |
| -c, --comment | Preenche o campo de descrição (GECOS) | |
| -D, --defaults | Mostra os valores padrão; com opções, altera os valores padrão |
| Opção | Copiar | Descrição |
|---|---|---|
| -d, --home-dir | Define o caminho do diretório home | |
| -u, --uid | Define o UID | |
| -e, --expiredate | Define a data de expiração da conta (YYYY-MM-DD) | |
| -f, --inactive | Número de dias após a expiração da senha até a conta não poder mais ser usada | |
| -r, --system | Cria uma conta de sistema | |
| -N, --no-user-group | Não cria um grupo com o mesmo nome da conta | |
| -p, --password | Define 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) ALLuseradd -G wheel user2Consultando 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.
4️⃣ Exemplos práticos do comando useradd
🔲 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/bashO 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/devuserLogo 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 existQuando 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/bshOutro 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:!!:20771useradd, 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 -DGROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yesHOME, 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.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 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 user1Changing 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/passwdshadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64No 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ção | Tarefa |
|---|---|
| -S, --status | Mostra o status da senha em uma linha |
| -l, --lock | Bloqueia a senha, acrescentando ! antes do hash |
| -u, --unlock | Desbloqueia a senha |
| -d, --delete | Exclui a senha |
| -e, --expire | Expira a senha na hora; troca no próximo login |
| -x, --maximum | Número máximo de dias de uso da senha |
| -n, --minimum | Número mínimo de dias de uso da senha |
| -w, --warning | Dias de aviso antes da expiração |
| -i, --inactive | Dias após a expiração até a conta ser desativada |
| --stdin | Recebe 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 rootroot 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 nobodyOnly 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 -Swebuser P 2026-01-20 0 99999 7 -1Ao 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
Excluir conta
Comando userdel: opções, exclusão do diretório home com -r e erros ao excluir contas no Linux
Um artigo sobre como excluir uma conta com userdel e remover também o diretório home e o arquivo de e-mail com a opção -r.
ℹ️ 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.