Panel Settings

The settings section allows you to configure global panel behavior, security policies, mail delivery, third-party integrations, and visual branding. Navigate to Admin > Settings to access these pages.

General Settings

Found under Admin > Settings > General:

• Panel Name -- The display name shown in the header, page titles, and emails.
• Panel URL -- The public-facing URL of your panel (e.g., https://panel.example.com). Used for generating links in emails, install scripts, and API responses.
• Default Role -- The role assigned to newly registered users.
• Timezone -- The default timezone used for display purposes.

Feature Toggles

Found under Admin > Settings > Features:

• Registration Enabled -- Whether new users can register accounts through the public registration page.
• Email Verification Required -- Whether new accounts must verify their email address before gaining full access.
• Billing Module -- Enable or disable the entire billing system (products, orders, invoices, credits).
• Support Tickets -- Enable or disable the support ticket system.
• Referral Tracking -- Show a "How did you find us?" question during registration or checkout.

Security Settings

Found under Admin > Settings > Security:

• Two-Factor Authentication Enforcement -- Require all users (or only admins) to enable TOTP-based 2FA. Users without 2FA are prompted to set it up on their next login.
• Password Minimum Length -- Minimum password length for new accounts and password changes.
• Session Lifetime -- How long user sessions remain valid before requiring re-authentication.
• Brute Force Protection -- Configures the maximum failed login attempts before temporary account lockout, and the lockout duration.

Mail Configuration

Found under Admin > Settings > Mail:

Configure SMTP settings for outbound email (password resets, email verification, billing notifications, ticket updates):

• SMTP Host -- The mail server hostname (e.g., smtp.mailgun.org).
• SMTP Port -- Typically 587 (STARTTLS) or 465 (SSL).
• SMTP Username / Password -- Authentication credentials.
• From Address -- The sender email address.
• From Name -- The sender display name.
• Encryption -- TLS, SSL, or none.

Use the Send Test Email button to verify your configuration before saving.

OAuth / SSO

Found under Admin > Settings > OAuth:

BadgerPanel supports single sign-on via OAuth2 providers. Each provider can be independently enabled for login, registration, or account linking:

• Google -- Standard OAuth2 with OpenID Connect.
• Discord -- Popular for gaming communities.
• GitHub -- Developer-oriented SSO.
• Microsoft -- Azure AD / Microsoft account SSO.
• Twitter/X -- OAuth2 with PKCE.

For each provider, configure:

• Client ID and Client Secret -- Obtained from the provider's developer console.
• Allow Login -- Existing users can log in via this provider.
• Allow Registration -- New users can create accounts via this provider.
• Auto Link -- Automatically link OAuth accounts to existing users when the email matches.
• Button Color and Icon -- Customize the appearance of the SSO button on the login page.

Branding and Theming

Found under Admin > Appearance:

• Themes -- Customize the panel's color scheme. BadgerPanel includes a default theme and supports custom theme presets with primary, secondary, and accent colors.
• Fonts -- Configure the font family used throughout the panel.
• Logo Upload -- Upload a custom logo and favicon displayed in the header and browser tab.

Theme changes apply immediately to all users.

Integrations

Found under Admin > Settings > Integrations:

Configure API keys for third-party services used by panel modifications:

• CurseForge API Key -- Enables searching the CurseForge mod catalog from the Minecraft Mod Manager. Without this key, mod search falls back to Modrinth, Spigot, and Hangar only.

Additional integrations can be added as panel modifications are installed.