User Management

BadgerPanel maintains a user database for all customers who access the panel. Administrators can create, edit, search, suspend, and manage user accounts and their server assignments.

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.

Users can be in one of the following statuses:

• active -- The account is in good standing and the user can log in.
• suspended -- The account is locked. The user cannot log in or manage servers.
• pending -- The account was created but email verification has not been completed (if email verification is enabled).
• deleted -- The account has been soft-deleted and is no longer accessible.

Creating a User

1. Navigate to Admin > Users and click Create User.
2. Fill in the required fields:
   • Email -- Must be unique across all accounts.
   • Username -- Must be unique, 3-64 characters.
   • Password -- Minimum 8 characters. The password is hashed with Argon2id before storage.
   • First Name / Last Name -- Optional.
3. Select a Role from the dropdown. The default role is applied if none is selected.
4. Click Create.

The user receives an active account immediately. If you want the user to verify their email first, enable the email verification requirement in Admin > Settings > Security.

Editing a User

Open a user's detail page by clicking their row in the user list. From here you can modify:

• Email, Username, First Name, Last Name -- Basic identity fields.
• Password -- Set a new password. The user is not notified automatically; communicate the change separately.
• Role -- Change the user's role to adjust their permissions and rate limits.
• Status -- Toggle between active and suspended.

Changes are saved immediately when you click Save.

Suspending a User

Suspending a user locks their account. They cannot log in, and all API requests with their credentials are rejected. Their servers are not automatically stopped or suspended; handle server suspension separately if needed.

To suspend a user:

1. Open the user's detail page.
2. Change the status to Suspended.
3. Click Save.

To reactivate, change the status back to Active.

Server Assignments

The user detail page includes a Servers tab listing all servers owned by the user. From this tab you can:

• View the server name, node, status, and resource allocation.
• Click a server to navigate to its admin detail page.
• Reassign server ownership by editing the server and changing the owner field.

Two-Factor Authentication

The user detail page shows whether the user has enabled TOTP-based two-factor authentication or WebAuthn security keys. Administrators cannot enable 2FA on behalf of a user, but can disable it if the user is locked out. Use this with caution, as it reduces account security.

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 detail page and click Delete User. Confirm the deletion in the dialog.