Settings

The Settings section gives administrators control over how the QuickBox Pro dashboard behaves, looks, and communicates. It is organized into six dedicated pages, each focused on a specific area of configuration.

Admin only

All Settings pages require admin privileges (admin.settings.read permission to view, admin.settings.update to modify). Navigate to Settings from the sidebar.

What you can configure

⚙️ General

Instance identity, timezone, themes, display preferences, branding, feature flags, and additional dashboard settings

📧 Email

SMTP or third-party email provider setup, email templates, test sends, and delivery logs

🔔 Notifications

Compose and send notifications, manage templates, view history, and configure delivery channels (Discord, Signal)

⏱️ Sessions

Session timeouts, idle timeouts, cookie persistence, concurrent session limits, and bulk session invalidation

🛡️ Security

Banned IPs, disallowed usernames, firewall rule viewer, and country-based access control (geo-lock and geo-block)

📝 Registration

Activation modes, default disk quotas, username and password policies, and welcome email configuration

Settings pages

Explore each settings area

General Settings

Instance name, timezone, themes, branding, feature flags, and display options

Email Settings

Email provider configuration, templates, and delivery log

Notification Settings

Compose notifications, manage channels, and view send history

Session Settings

Timeout policies, cookie persistence, and concurrent session limits

Security Settings

IP bans, username restrictions, firewall viewer, and geo-blocking

Registration Settings

Activation mode, quotas, username/password policies, and welcome email

How settings are saved

Each settings page has a Save button at the bottom of the form. Changes are not applied until you explicitly save. If you navigate away from a page with unsaved changes, the browser will warn you before leaving.

All settings are stored in the QuickBox Pro database and take effect immediately upon saving. Some settings — such as theme changes and feature flag toggles — are reflected across the dashboard instantly. Others — such as session timeout changes — apply to new sessions only.

CLI alternatives

A few settings can also be managed from the command line. For example, qb manage theme -o spectre sets the default theme and qb manage webroot -o yourdomain.com sets the server domain. The dashboard provides a more comprehensive settings interface with additional options not available via the CLI.

Getting Started

First-time setup including initial settings configuration

User Management

Users, groups, and roles — complements registration and session settings

System Administration

SSL, VPN, API, logs, and other system-level management

CLI Reference

Command-line alternatives for settings management