Updated: 10 November 2026 · Applies to: AzuraCast 0.24.0 (menu names and commands checked against the AzuraCast source code and official documentation, not on a live install)
To add a user in AzuraCast, log in as an administrator, open Administration, go to Users > User Accounts and click Add User. Enter the e-mail address, a password and a display name, choose one or more Roles and save. The roles decide what the new user can see and do, so create the role first if the right one does not exist yet.
How users, roles and permissions fit together
AzuraCast does not give permissions to users directly. According to AzuraCast, one or more users are placed in a role, and each role holds permissions that are either global (the whole installation) or limited to one station.
- Administrator: a role with the global All Permissions permission. This user can manage every station, every user and all system settings.
- Station manager: a role with the station permission All Permissions for one station only. This user has full control of that station and nothing else.
- Station helper: a role with a few station permissions, for example Manage Station Media and Manage Station Broadcasting for someone who uploads music and skips tracks, or View Station Reports for someone who only reads listener statistics.
The station permissions in AzuraCast 0.24.0 are: All Permissions, View Station Page, View Station Reports, View Station Logs, Manage Station Profile, Manage Station Broadcasting, Manage Station Streamers, Manage Station Mount Points, Manage Station Remote Relays, Manage Station Media, Delete Station Media, Manage Station Automation, Manage Station Web Hooks and Manage Station Podcasts. Note that Manage Station Media opens the Media Manager, but removing files also needs Delete Station Media.
Step 1: create a role (if you need a new one)
- Go to Administration > Users > Roles & Permissions and click Add Role.
- Enter a Role Name, for example "Morning Show Station".
- Under Global Permissions, tick nothing for a station-only user. Global permissions apply across the entire installation.
- Under Station Permissions, click Add Station, pick the station and tick only the permissions this person needs.
- Save the role.
More detail on each permission is in Roles and Permissions within AzuraCast and how to set up roles for users and assign streams to them.
Step 2: add the user
- Go to Administration > Users > User Accounts and click Add User.
- Fill in E-mail Address (this is the login name and must be a valid address), Password (required for a new user) and Display Name.
- In Roles, choose the role you created. A user can be in more than one role; the permissions add up.
- Save. The user now appears in the list with their roles.
To check what the new user sees, click Log In next to their name in the user list. This signs you in as that user, which is a quick way to confirm the role is right before you hand over the login.
A panel user is not the same as a live DJ account. DJs who only need to broadcast live get a Streamer/DJ Accounts login under the station's Live Streaming menu, not a user account. See how to broadcast live with AzuraCast.
AzuraCast login: where users sign in
Every user signs in at the same address: your AzuraCast domain or IP followed by /login, for example https://radio.example.com/login. The page asks for the E-mail Address and Password, and also offers Sign In with Passkey for users who have set one up under My Account. After login, a station-only user sees just their own stations; the Administration button only appears for roles with global permissions.
If you host your station with Ucartz, your panel address and first login are in the welcome email and in the client area.
Forgotten password
- From the panel: open User Accounts, click Edit next to the user, type a new password and save (leave it blank to keep the current one). You can also click Login Link to create a one-time Reset Password or Magic Login Link with an expiry time in minutes, and send that link to the user.
- Forgot your password? link: on the login page this sends a recovery email only if Enable Mail Delivery and the SMTP details are set under Administration > System Settings > Services. Without mail, AzuraCast tells the user to contact an administrator.
- Locked out as the only administrator: on a self-hosted Docker install, run the command below over SSH. It prints a temporary password and also removes two-factor authentication from that account.
cd /var/azuracast ./docker.sh cli azuracast:account:reset-password admin@example.com
List all accounts from the command line
To see every user account with its roles, run:
cd /var/azuracast ./docker.sh cli azuracast:account:list
The table shows E-mail Address, Name, Roles and Created for each account. Two related commands: azuracast:account:set-administrator admin@example.com makes an existing account a global administrator, and azuracast:account:login-token admin@example.com creates a one-time login URL (valid for 30 minutes by default). Run them with ./docker.sh cli in the same way. These commands need root SSH access to the AzuraCast server, so they apply to your own VPS or dedicated server, not to a shared station login.
Tips
- Give each person their own account instead of sharing the administrator login, so the audit log shows who changed what.
- Start with the fewest permissions and add more when needed. Only trusted people should get global All Permissions.
- In AzuraCast 0.24.0 the User Accounts and Roles & Permissions pages are shown only to roles with global All Permissions.
New to AzuraCast? Start with the initial system setup and creating a station, a user and their permissions.
Official documentation: AzuraCast Users and AzuraCast Roles and Permissions.