User Management
BadgerPanel maintains a user database for all customers and administrators. This guide covers creating, editing, and managing user accounts from the admin panel.
User List
Navigate to Admin > Users to view all registered users. The list displays each user's username, email, role, status, server count, and registration date. Use the search bar to filter by username or email.
User Statuses
| Status | Description |
|---|---|
| Active | Account is in good standing and the user can log in |
| Suspended | Account is locked - the user cannot log in or manage servers |
| Pending | Account was created but email verification has not been completed |
| Deleted | Account has been soft-deleted and is no longer accessible |
Creating a User
- Navigate to Admin > Users and click Create User.
- Fill in the required fields:
- Email - must be unique across all accounts
- Username - must be unique, 3-64 characters
- Password - minimum 8 characters
- First Name / Last Name - optional identity fields
- Select a Role from the dropdown. If no role is selected, the default role (User) is applied.
- Click Create.
The user receives an active account immediately. If email verification is required (configured in Admin > Settings > Security), the user must verify their email before gaining full access.
Editing a User
Open a user's detail page by clicking their row in the user list. You can modify:
- Email, Username, First Name, Last Name - identity fields
- Password - set a new password (the user is not notified automatically)
- Role - change the user's role to adjust permissions and rate limits
- Status - toggle between active and suspended
Click Save after making changes. Role and status changes take effect immediately.
Suspending a User
Suspending a user locks their account. They cannot log in and all API requests with their credentials are rejected. To suspend a user, open their detail page and change the status to Suspended.
Their servers are not automatically stopped when a user is suspended. If you need to stop their servers as well, handle server suspension separately from the server list or server detail pages.
Deleting a User
Deleting a user performs a soft delete. The account is marked as deleted and the user can no longer log in. Their servers are not automatically removed.
Before deleting a user, transfer or remove their servers to avoid orphaned resources. Navigate to the user's detail page and click Delete to proceed.
Server Assignments
The Servers tab on a user's detail page shows all servers owned by that user. From this tab you can:
- View each server's name, status, node, and resource usage
- Click through to a server's detail page for management
- Quickly identify how many resources a user is consuming across all their servers
This is useful for reviewing a user's account before making changes like suspension or deletion.
Next Steps
- Roles and Permissions - configuring what users can access
- Server Management - managing individual servers
- API Keys - managing API access tokens
