General Settings

The General Settings page is the largest settings page in the dashboard, containing nine sections that control your instance identity, appearance, and behavior. Each section is accessible via sidebar dot-navigation, so you can jump directly to the area you need.

Admin only

General Settings requires admin privileges (admin.settings.read to view, admin.settings.update to modify). Navigate to Settings > General from the sidebar.

Sections overview

🏷️ Instance Settings

Name your server, set a description, choose the default landing page, and toggle maintenance mode

🌍 Timezone & Locale

Set the server timezone, date format, and locale for consistent timestamps across the dashboard

🔐 Sessions & Security

Quick session timeout configuration — for full session management, see the dedicated Sessions settings page

🎨 Display Preferences

Choose the default theme, page density, and software view mode (grid or list)

📊 Additional Dashboard Settings

Network interface selection, mount point management, vnStat configuration, and Redis status

📤 Uploads

Maximum upload size and allowed file types for user uploads

🖼️ Branding

Custom logo, favicon, and auth page background image with image cropping

🔑 Auth Pages

Customize the login and registration page text and layout

🚩 Feature Flags

Enable or disable major features like the Streaming Dashboard, Web Console, and config editing

Instance settings

Configure the identity and behavior of your QuickBox Pro instance:

Instance name — A friendly name for your server, displayed in the dashboard header and browser title
Description — An optional description shown on the login page
Default landing page — The page users see after logging in. You can set different landing pages for different roles
Maintenance mode — When enabled, non-admin users see a maintenance notice instead of the dashboard. Admin users can still access all pages

Timezone and locale

Set how dates and times are displayed throughout the dashboard:

Timezone — Select your server’s timezone from a grouped dropdown. All timestamps in the dashboard (logs, audit events, session info) use this setting
Date format — Choose how dates are formatted (e.g., DD/MM/YYYY, MM/DD/YYYY, YYYY-MM-DD)
Locale — Set the display locale for number formatting and localization

Sessions and security

This section provides a quick view of session timeout settings:

Session timeout — How long a session lasts before requiring re-authentication
Idle timeout — How long an inactive session persists before expiring

Full session management

This section shows a summary of session settings. For complete session configuration — including persistence, cookies, concurrency limits, and bulk invalidation — visit the dedicated Session Settings page.

Display preferences

Control the visual appearance of the dashboard for all users:

Default theme — Set the theme applied to new users and users who have not chosen their own theme

Theme	Style	Notes
Spectre	Dark with green accents	Default theme
Smoked	Dark with blue accents
Defaulted	Light with blue accents
Reel	Warm dark with amber accents	Plex-inspired

Page density — Adjust the spacing and compactness of UI elements
Default software view — Choose whether the application list on the App Dashboard defaults to grid or list view

CLI alternative

You can set the default theme from the command line with qb manage theme -o spectre (or any theme name).

Additional dashboard settings

Configure infrastructure settings that affect how the dashboard collects and displays data:

Network interface — Select which network interface is used for bandwidth monitoring on the System Dashboard. Servers with multiple NICs can choose the primary one here
Mount points — Manage the storage mount points that appear in disk usage displays. Add, remove, or reorder mount points
vnStat configuration — Settings for the vnStat network traffic monitor that powers the bandwidth history charts
Redis status — View the status of the Redis connection if Redis is configured for caching

Uploads

Control file upload behavior:

Maximum upload size — Set the maximum file size users can upload (for avatars, banners, and other media)
Allowed file types — Configure which file types are accepted for uploads

Branding

Customize the visual identity of your QuickBox Pro instance:

Logo — Upload a custom logo displayed in the sidebar and login page. The image cropper lets you adjust the logo before saving
Favicon — Upload a custom favicon for the browser tab
Auth page background — Upload a background image for the login and registration pages

All branding images support PNG, JPG, and WEBP formats with an integrated image cropper.

Auth pages

Customize the text and layout of the login and registration pages:

Login page text — Add custom markdown text displayed on the login page (announcements, server rules, welcome message)
Registration page text — Add custom markdown text on the registration page
Auth page layout — Configure the visual layout of authentication pages

Feature flags

Enable or disable major dashboard features. Feature flags control whether certain functionality is available to users:

Feature	What it controls
Streaming Dashboard	Enables the Streaming Dashboard for monitoring Emby and Jellyfin sessions. When disabled, all streaming-related pages and sidebar items are hidden
Web Console	Enables the built-in browser-based terminal. The Web Console is a custom module integrated directly into the dashboard — no separate application is needed. When disabled, the Web Console page and sidebar item are hidden entirely
Config Editing	Allows editing application configuration and nginx files from the App Dashboard's application details panel
Mirror	Enables the session mirroring feature on the Streaming Dashboard, allowing admins to cast a session to another device

Feature availability

Some features have additional requirements beyond the flag. The Streaming Dashboard requires at least one media server (Emby or Jellyfin) to be configured. The Web Console is a built-in dashboard module that only requires the feature flag and the admin.system.console permission — no application installation is needed.

CLI equivalents

Dashboard Setting	CLI Command
Default theme	`qb manage theme -o <theme>`
Server domain	`qb manage webroot -o <domain>`

Dashboard advantage

Most General Settings options are available only through the dashboard. The CLI covers theme and webroot management, but features like branding, feature flags, auth page customization, and display preferences are dashboard-exclusive.

Best practices

Do

Set a descriptive instance name so users know which server they are connecting to
Configure the correct timezone before reviewing logs or audit events — timestamps depend on this setting
Enable only the feature flags you need — disabling unused features keeps the interface clean for your users
Upload a custom logo and favicon to give your instance a professional, branded appearance
Set different default landing pages per role if admins and regular users have different workflows

Don't

Don't enable maintenance mode without notifying your users first — they will be locked out of the dashboard
Don't forget to click Save after making changes — the browser warns you, but unsaved changes are lost on navigation
Don't set an extremely short session timeout — it creates a frustrating experience for users who are actively working
Don't enable the Streaming Dashboard flag without at least one Emby or Jellyfin server configured — users will see an empty page

FAQ

Individual users can change their own theme from the theme selector in the top bar. The General Settings page sets the default theme applied to new users and those who have not chosen a theme.

Non-admin users see a maintenance notice when they try to access the dashboard. Admin users can still log in and use all pages normally. Maintenance mode is useful during major updates or when troubleshooting server issues.

Yes. The login and registration page text fields support markdown formatting, so you can add headers, links, bold text, and other formatting to your custom messages.

Session timeout is the maximum duration a session can last regardless of activity. Idle timeout ends a session after a period of inactivity. For full session configuration, visit the Session Settings page.

Yes. When you toggle a feature flag and save, the change takes effect immediately. Users who are currently logged in will see the feature appear or disappear on their next page navigation.

Session Settings

Full session timeout, persistence, and concurrency configuration

Security Settings

IP bans, username restrictions, and geo-blocking

Registration Settings

Activation modes, quotas, and password policies

Streaming Dashboard

Learn about the Streaming Dashboard before enabling the feature flag

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