Groups

Groups control which applications users can access on your QuickBox Pro server. While roles determine administrative capabilities, groups determine which software each user can see, install, and manage. A user’s Package Management catalog on the App Dashboard is filtered by their group membership — they can only install, remove, reinstall, and update applications that their group allows. Assign users to groups, and configure each group with the application categories it should have access to.

Admin only

Groups requires admin privileges. admin.groups.read is needed to view groups, and admin.groups.manage is needed to create, edit, or delete groups. Navigate to User Management > User Groups from the sidebar.

Key features

📦 Application Access Control

Assign access to all 11 software categories — users only see apps in their group's allowed categories

👥 Group Membership

Add and remove users from groups to manage their application access

🔧 Custom Groups

Create custom groups with tailored application access for different user types

📊 Group Metrics

See member counts, app access totals, and usage at a glance

🔍 Filter & Search

Filter groups by type (system, custom, has users, has apps, empty) and search by name

🔒 System Protection

Default system groups cannot be deleted — they always exist as a baseline

Default groups

QuickBox Pro ships with two system groups:

Group	Priority	Type	Application Access
Administrator	100	System	All applications in all 11 categories
Access	10	System	Download clients only

System groups cannot be deleted. The Administrator group’s app access can be modified, but admin-level users are always members of this group and cannot be removed from it.

Creating groups

To create a custom group:

Click the Create Group button
Enter a group name and optional description
Select which application categories the group should have access to — you can select entire categories or individual applications
Save the group

Custom groups are useful when you want different users to have access to different sets of applications. For example, you might create a “Media Users” group with access to media servers and download clients, and a “Managers” group with access to media management and automation tools.

Managing group members

Add or remove users from a group through the group editor:

Add members — Select users to add to the group
Remove members — Remove users from the group

A user can belong to multiple groups. Their effective application access is the union of all their groups’ permissions — if any group they belong to grants access to an application, they can use it.

Application categories

Groups grant access to applications organized in 11 categories:

Category	Includes
Media Management	Sonarr, Radarr, Lidarr, Bazarr, and more
Media Servers	Plex, Jellyfin, Emby, Tautulli, and more
Media Requests	Overseerr, Jellyseerr, Ombi, and more
Download Clients	qBittorrent, Deluge, rTorrent, SABnzbd, and more
Indexers & Trackers	Prowlarr, Jackett, Autobrr, and more
Automation & Tools	FileBot, FlexGet, Unpackerr, and more
File Management	Nextcloud, Syncthing, Duplicati, and more
E-Books & Comics	Calibre, Kavita, Komga
Remote Access	noVNC, X2Go
Communication	The Lounge, Quassel, ZNC
Utilities & System	Netdata, Fail2ban, WireGuard, and more

When editing a group, you can select entire categories or pick individual applications within each category for fine-grained control.

Best practices

Do

Use groups to separate different types of users — for example, media consumers who only need access to media servers vs power users who also need download clients and automation tools
Keep the default Access group as a baseline for regular users and create additional groups for expanded access
Name groups clearly so their purpose is obvious — 'Media Team', 'Download Users', 'Full Access' are better than 'Group 1', 'Group 2'
Review group membership when adding new applications to ensure the right users have access

Don't

Don't give all groups access to all categories unless every user on the server should see every application
Don't forget that group access is additive — a user in multiple groups gets access to the union of all their groups' applications
Don't delete a system group — they cannot be deleted and attempting to do so will show an error

FAQ

Groups control application access — which installed software a user can see and use. Roles control administrative capabilities — what actions a user can perform in the dashboard (managing users, settings, software). Both work together: a user's role determines their admin powers, and their group membership determines which apps they can access.

Yes. A user can belong to multiple groups. Their effective application access is the union of all their groups — if any group grants access to an application, the user can use it.

The user will not have access to any applications in the dashboard. They can still log in and access their profile, but the application panels will be empty.

Yes. The group editor allows you to select entire categories or individual applications within each category. This gives you fine-grained control over exactly which applications each group can access.

Group management is a dashboard-exclusive feature. The CLI does not have direct commands for managing groups, though the initial default groups are seeded during installation.

User Admin

Assign users to groups when creating or editing accounts

Roles & Permissions

Manage admin capabilities with the RBAC permission system

Registration Settings

Set default quotas and policies for new users

App Management

The application panel where group access takes effect

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support

Feature Previews

Community Configs

Active Discussions

Join Discord Server