User Management

Manage local Unix users and groups for file share access. For domain-based authentication, see Active Directory & Kerberos.

Access

Navigate to User Management in the Web UI sidebar.

Users

Create a User

1. Click Add User
2. Fill in:

Field	Description	Default
Username	Login name	—
Full Name	Display name (gecos)	—
UID	User ID	Auto-assigned
GID	Primary group ID	Auto-assigned
Home Directory	Home directory path	/home/<username>
Shell	Login shell: bash, sh, zsh, or false (no login)	/bin/bash
Password	User password	—
Samba Authentication	Enable SMB access for this user	Off

3. Click Create

Edit a User

Click on a user card to edit inline:

• Full Name
• Shell (dropdown)
• Samba toggle

Set Password

Select a user and click Set Password to change their password.

Delete a User

Select a user and click Delete.

Groups

Create a Group

1. Switch to the Groups tab
2. Click Add Group
3. Fill in:

Field	Description
Group Name	Group name
GID	Group ID
Members	Select initial members from user list

4. Click Create

Edit Group Members

1. Select a group
2. Click Edit
3. Add or remove members using the user selection interface
4. Click Save

Delete a Group

Select a group and click Delete.

SMB Users

To create users that can authenticate to SMB shares without Active Directory:

1. Create a user with Samba Authentication enabled
2. Set a password

The Samba badge appears on the user card indicating SMB access is enabled.

To enable Samba for an existing user, click the user card and toggle the Samba option, then set a password.

CLI

# Create a Unix user
mayacli create creds jdoe type=user uid=1001 gid=1001 \
  home=/home/jdoe shell=/bin/bash gecos="John Doe"

# Create an SMB-enabled user
mayacli create creds smbuser type=user samba=yes password=secret123

# Create an SMB user (prompt for password)
mayacli create creds smbuser type=user samba=yes password

# Create a group
mayacli create creds developers type=group gid=2001

# Add user to group
mayacli bind creds jdoe group=developers

# Remove user from group
mayacli unbind creds jdoe group=developers

# Change user shell
mayacli set creds jdoe shell=/bin/zsh

# Change password
mayacli set creds smbuser password=newsecret samba=yes

# Show all users
mayacli show creds type=user

# Show all groups
mayacli show creds type=group

# Delete a user
mayacli delete creds jdoe

# Delete a group
mayacli delete creds developers

See CLI Guide for the full command reference.