User Accounts

User Accounts

This section covers the various user roles in Beszel, their permissions, and how to reset or change passwords. Note that Beszel user roles operate on top of a PocketBase back-end, and some features (like superuser creation) are handled through PocketBase directly.

User Roles

Beszel defines three main user roles:

• Admin: Has access to additional features and settings such as backups, SMTP configurations, and other administrative options within the Beszel Hub. The first user created is automatically granted Admin privileges (and also becomes a PocketBase superuser with the same credentials).
• User: Can create and manage their own systems and alerts but does not have access to the full PocketBase or advanced Beszel administrative settings.
• Read Only: Can view systems shared by an admin and create alerts, but cannot create new systems or make system-level changes.

Important: PocketBase superusers are separate from Beszel user roles. Promoting a Beszel user to Admin role does not create a PocketBase superuser account. If you want them to have access to the PocketBase admin panel (/_/#/ in the browser), you must create a new superuser for them manually via the PocketBase CLI or the Beszel superuser command.

Reset Password

To reset your password, you can use the built-in superuser command in Beszel. The upsert subcommand will reset the password if a superuser already exists for the specified email, or it will create a new superuser if one does not exist.

Once you have a PocketBase superuser account, you can change any user's password via the PocketBase admin interface under the users table.

Docker

docker exec beszel /beszel superuser upsert [email protected] password

This command will reset (or create) a PocketBase superuser with the specified email ([email protected]) and password (password).

To see all superuser options:

docker exec beszel /beszel superuser --help

Binary

./beszel superuser upsert [email protected] password

And to list all superuser options:

./beszel superuser --help