Skip to content

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

StatusDescription
ActiveAccount is in good standing and the user can log in
SuspendedAccount is locked - the user cannot log in or manage servers
PendingAccount was created but email verification has not been completed
DeletedAccount 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
    • First Name / Last Name - optional identity fields
  3. Select a Role from the dropdown. If no role is selected, the default role (User) is applied.
  4. 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

BadgerPanel Documentation