Quick‐Start

---

title: Quick Start

Quick Start

This page helps you get productive in a minute.

Launch

usrgrp-manager           # browse read-only
sudo usrgrp-manager      # required for creating/modifying users/groups

Basic workflow

1. Open the app; users and groups are listed in panes.
2. Use the search box to filter.
3. Select an entry to view details, edit, or delete.
4. Confirm actions when prompted.

Common tasks

• Add a user: choose Users → Add, fill fields, confirm.
• Edit a user: select user → Edit, change shell/home/groups → Save.
• Delete a user: select user → Delete, confirm.
• Manage groups: switch to Groups pane → Add/Edit/Delete, manage membership.

Shortcuts

Shortcuts may vary slightly by version; typical keys include:

• Navigation: Arrow keys, PgUp/PgDn
• Search: /
• Add: a
• Edit: e
• Delete: d
• Confirm: Enter
• Cancel: Esc
• Quit: q

Safety reminders

• System accounts and groups are sensitive. The UI shows extra warnings for low GID groups (e.g., GID < 1000) to encourage caution before deletion. This reminder does not block the action.

Troubleshooting

• Permission denied or changes not applied → run with sudo.
• Centralized identity (LDAP/SSSD/AD): local edits may not affect remote users.
• If you encounter issues, please open an issue with steps to reproduce.