Add Users and Roles¶
BillTracker supports admin and user roles.
This page explains the difference between the two roles, the user management actions an admin can take, and what single-user mode does.
What can each role do?¶
| Role | Access |
|---|---|
admin |
Server configuration, users, backups, cleanup, auth, status, and roadmap |
user |
User-owned bills, payments, categories, imports, exports, profile, and planning pages |
An admin account may also have normal user access unless it is the protected
bootstrap admin marked is_default_admin.
What user management actions can an admin take?¶
Admins can:
- Create users
- Reset passwords
- Change roles
- Activate or deactivate accounts
- Change usernames
- Delete users
Role changes and account deactivation invalidate affected sessions.
What is single-user mode?¶
In single-user mode, BillTracker attaches one configured regular user without a session login. Admin routes still require an authenticated admin session. Use this mode only on a trusted private deployment.
Next steps¶
- Configure authentication in Configure Authentication.
- Run the day-to-day checklist in Run It Day to Day.
- Review the auth safety rules in Tune Security Settings.