OpenPanel
Configure nameservers, branding, and UI display settings for the OpenPanel interface.
Brandingβ
Customize the appearance of OpenPanel to match your brand:
- Brand name
Set a custom name to appear in the OpenPanel sidebar and on login pages by entering it in the "Brand name" field.
-
Logo
Display a logo instead of the brand name by providing a URL to the image in the "Logo image" field.
Supported formats:.pngor.svg
Recommended size:200px Γ 36px -
Logout URL
Specify the URL users are redirected to after logging out from the panel (typically your main website).
Nameserversβ
- ns1
- ns2
- ns3
- ns4

Guide on how to properly configure nameservers
If no nameservers are set but the DNS module is enabled, a recommendation is shown to either set at least ns1 and ns2, or disable the DNS module if it won't be used, so BIND9 isn't autostarted and DNS zone files aren't created for every domain.
Usersβ
Settings for OpenPanel user accounts:
- Allow Users to Change Username: If allowed, users can change their username from the Account > Settings page.
- Allow Subdomain Sharing: If allowed, users can add subdomains for domains that another user owns.
- Forbidden Usernames: List of usernames that can not be used, one per line.
- Restricted Domains: List of domains that can not be used, one per line.
- DNS record types users can add and edit: Record types offered in the DNS Zone Editor. See DNS record types.

DNS record typesβ
Choose which record types users can add and edit in the OpenPanel DNS Zone Editor. Click a type to turn it on or off, or click Restore default to go back to the default list.
| Type | On by default | Used for |
|---|---|---|
A, AAAA | Yes | IPv4 and IPv6 address of a name |
CAA | Yes | Which certificate authorities can issue SSL for the domain |
CNAME | Yes | Alias to another name |
MX | Yes | Mail servers for the domain |
SRV | Yes | Host and port of a service |
TLSA | Yes | Certificate pinning with DANE |
TXT | Yes | Text values, such as SPF and verification records |
HTTPS, SVCB | No | Connection hints for browsers and other clients |
NS | No | Delegates a subdomain to other nameservers, the domain itself is refused |
SSHFP | No | SSH host key fingerprints |
URI | No | Maps a name to a URL |
DMARC | No | Form helper that saves a TXT record on _dmarc, not a real record type |
Save the settings and restart OpenPanel for the change to apply.
What changes for users:
- The add and edit forms only offer the allowed types, and adding or editing any other type is refused, also through the API.
- Existing records of other types stay in the zone and keep working. Users can't edit them, but they can delete them.
- The Advanced Editor edits the zone file directly, so it isn't limited by this setting.
The value is saved as dns_record_types and can also be set with OpenCLI.
Displayβ
Additional display settings include:
- Menu Style: The default menu for OpenPanel users - Classic (expandable groups) or Modern (one link per area, with that area's pages as tabs at the top of each page). Users can still switch to the other style for themselves, see Menu Style. The same setting also switches OpenAdmin's own menu, right after saving.
- Avatar Type: Choose between Gravatar, Letter, or Icon for user avatars.
- Theme: The look of the OpenPanel user panel. Default uses the templates built into OpenPanel. Below it are the installed themes (folders in
/etc/openpanel/openpanel/templates/, shown with their screenshot, version, author and license from the theme'sreadme.txt) and the themes from the official list that aren't installed yet, each with an Install button. The chosen theme is saved astemplate=and applies after OpenPanel restarts. To build your own theme or submit one to the list, see How to create and install themes. - Charts Mode for Resource Usage: Select to show 1 chart, 2 charts, or no charts on the Resource Usage page.
- Enable Password Reset: Allow users to reset passwords via the login form (not recommended for security reasons). When enabled without SMTP configured, a warning links to SMTP settings, since reset emails won't reach users until it's set up.
- Display 2FA Widget: Show a message on users' dashboards encouraging them to enable Two-Factor Authentication for enhanced security.
- Display How-to Guides Widget: Display helpful how-to articles on usersβ dashboard pages. When enabled, a How-to Articles field appears below to edit the Knowledge Base articles shown (requires an active Enterprise license and a non-reseller account to edit).
- Display Link to Report Bugs: Show a βFound a bug? Let us knowβ link at the bottom of all user pages for easy bug reporting.
- Display Country Flag Icons: Show country flags next to the last login IP in the OpenPanel dashboard.

Onboardingβ
- Enable Onboarding Wizard: Show a short guided setup wizard to new users on their first login. Steps the user has already set up are skipped (Webserver once they have a domain, Database once they have a database, Backups once a destination is configured, 2FA once it's enabled). See the Onboarding page for what users see.
The wizard doesn't have its own separate list of steps to configure - each step just mirrors a feature already enabled in Feature Manager (Webserver, PHP, Database, Varnish, Backups, WAF, IP Blocker, 2FA, Passkeys). Disable a feature there for a plan and its onboarding step disappears too for users on that plan.
To reset the wizard for a single user (for testing, or if they ask to see it again), delete their marker file over SSH:
rm /home/USERNAME/onboarding.completed
They'll be offered the wizard again next time they log in, minus any steps they've already set up.
You can also add your own custom steps to the wizard - for example, a step to enable Redis - without modifying OpenPanel itself. See Add Custom Steps to the Onboarding Wizard.
File managerβ
Configure the following settings for the File Manager:
- Files per Page: Number of files/folders displayed per page in the File Manager.
- Max File Size for Viewer: Maximum file size (in MB) allowed to be opened in the Viewer. Recommended maximum is 20 MB.
- Max File Size for Editor: Maximum file size (in MB) allowed to be opened in the Code Editor. Recommended maximum is 10 MB.
- Max File Size for Upload: Maximum file size (in MB) allowed to be uploaded via the File Manager. Recommended maximum is 2000 MB.
- Max File Size for Download: Maximum file size (in MB) allowed to be downloaded via the File Manager. Recommended maximum is 2000 MB.
- Auto-Purge Trash After: Number of days files remain in the userβs trash bin before automatic deletion. Setting to 0 disables auto-purge. Recommended setting is 30 days.
- Max Time for Compress Process: Maximum number of minutes before aborting archive compression processes. Recommended to keep this to a few minutes.
- Max Time for Extract Process: Maximum number of minutes before aborting archive extraction processes. Recommended to keep this to a few minutes.
- Max Time for Download Process: Maximum number of minutes before aborting file download processes. Recommended to keep this to a few minutes.
- Enable View and Edit Options for (textual) Extensions: Specify file extensions allowed to be opened and edited in the File Manager (should be textual file types).
- Enable View Option for (base64 image) Extensions: Specify image file extensions that can be displayed using base64 encoding in the Viewer.
- Enable Extract and Archive Options for (archives) Extensions: Specify archive file extensions that can be extracted using the File Manager.
A warning is shown when:
- a max file size for the Viewer, Editor, Upload or Download is bigger than the RAM limit of the OpenPanel container (set on Service Limits), since files that big can fail.
- Auto-Purge Trash is set to 0, since deleted files then pile up in users' Trash folders until they empty it themselves.
- Auto-Purge Trash is over 30 days, recommending to change the
opencli files-purge_trashschedule to weekly on Scheduled Actions.

Databasesβ
Settings for user's databases:
- Max Startup Time for MySQL: Maximum number of seconds to wait for MySQL to initialize before timing out.
- Max File Size for MySQL Import: Maximum file size (in GB) allowed for a MySQL import.
- Restricted MySQL (system) Users: List of MySQL usernames that users are not allowed to access/manage.
- Restricted MySQL (system) Databases: List of MySQL databases that users are not allowed to access/manage.
A warning is shown when:
- Max Startup Time for MySQL is under 10 seconds, since MySQL needs time to initialize on first start. If a custom
MYSQL_VERSIONis set for new users, at least 60 seconds is recommended, since the first start downloads that image from Docker Hub. - Max File Size for MySQL Import is bigger than the RAM limit of the OpenPanel container.

Securityβ
Captcha, 2FA, and password protections for login and signup forms:
- Captcha Provider: Choose between Disabled, Google reCAPTCHA, Cloudflare Turnstile, or Custom.
- Depending on the provider selected, enter the corresponding site key and secret key (or custom site key for the Custom provider).

Captcha requires the captcha plugin to be installed β these settings have no effect until it is installed.
- Minimum Password Strength: A value between 1-100 setting the minimum password strength required for all password input fields in OpenPanel (account, FTP, Emails, Databases, etc).
- Check Passwords Against Weakpass.com: When enabled, user passwords during account creation and reset are verified against Weakpass.comβs list of compromised passwords.
- Enforce 2FA: On login redirects users to 2FA setup page and prevents them from accessing other pages until 2FA is configured.
- Validate IP Address on Session Cookie: When enabled, a session cookie is rejected if the request's IP address doesn't match the IP it was issued to.
A warning is shown when Minimum Password Strength is below 50 (weak passwords are accepted), when the Weakpass.com check is off (passwords found in data breaches can be used), and when Validate IP Address on Session Cookie is off (a cookie stolen from a user, for example through phishing, can be reused from any IP).
Statisticsβ
Configure the following settings related to user login attempts, session management, and data retention:
- Failed Logins per Minute Before User is Rate-Limited: Number of failed login attempts allowed per minute from a single IP before that IP is temporarily rate-limited to prevent brute-force attacks.
- Failed Logins per Minute Before User is Blocked for 1 Hour: Threshold of failed login attempts per minute that triggers a 1-hour block for the offending IP address.
- Session Duration (in Minutes): Length of time a user session remains active before requiring re-authentication.
- Session Lifetime (in Minutes): Total maximum lifetime of a session, after which the user will be logged out regardless of activity.
- Login Records to Keep per User: Number of recent login attempts stored per user for audit and security tracking purposes.
- Activity Records to Store per User: Maximum number of user activity logs retained for reviewing past actions within the panel.
- Activity Items per Page: Number of activity log entries displayed per page in the user interface.
- Resource Usage Items to Display per Page: Number of resource usage records shown per page when viewing user or system resource statistics.
- Resource Usage Items to Log per User: Number of resource usage entries recorded and stored per user for historical analysis.
- Domains per Page: Number of domain entries displayed per page in domain management lists.
- Terminal Commands Timeout (in Seconds): Maximum number of seconds a Docker Terminal command can run before being timed out.
- PageSpeed API Key: If set, this API key is used to fetch data from Google PageSpeed Insights.
A warning is shown when Terminal Commands Timeout is under 30 seconds (it applies to both the OpenPanel web terminal and OpenAdmin), and when there are more than 10 sites on the server but no PageSpeed API key.

WordPressβ
Plugins and themes installed on new WordPress sites, and the profiles users can pick from on OpenPanel > WordPress > Install. These options are available on all license types and are saved together with the rest of the page.
Default plugins setβ
The global default list of WordPress plugins, installed on new WordPress sites when the user keeps Default in the Plugins & themes set field of the install form (or when there are no WordPress profiles). If the user has their own plugins set, theirs is used instead. Enter one item per row. Supported formats:
- wp_org_slug β the plugin slug from the WordPress.org plugin page
- URL β a direct link to a
.zipplugin file hosted online
Stored in /etc/openpanel/wordpress/sets/plugins.txt file.
Default themes setβ
The global default list of WordPress themes, installed on new WordPress sites when the user keeps Default in the Plugins & themes set field of the install form (or when there are no WordPress profiles). If the user has their own themes set, theirs is used instead. Enter one item per row. Supported formats:
- wp_org_slug β the theme slug from the WordPress.org themes page
- URL β a direct link to a
.ziptheme file hosted online
Stored in /etc/openpanel/wordpress/sets/themes.txt file.
WordPress profilesβ
Named sets of plugins and themes, for example E-commerce (WooCommerce), Blog or Business website. When at least one profile exists, users get a Plugins & themes set field on OpenPanel > WordPress > Install where they pick:
- Default: the global plugins set and themes set above, or the user's own sets.
- One of your profiles: only that profile's plugins and themes are installed.
- None, clean WordPress: no extra plugins or themes are installed.
There are no profiles by default, and until you add one the install form looks the same as before.
To add a profile, open Add WordPress profile, enter a name and list the plugins and themes (click + Add another profile to add more in the same save), one per line, in the same formats as the global sets (WordPress.org slug or a URL to a .zip file, lines starting with # are ignored). Click Save changes. Existing profiles are listed above it: open one to rename it or change its plugins and themes and click Save changes, or click Delete to remove it.
Each profile is stored as a JSON file in /etc/openpanel/wordpress/sets/profiles/, for example:
{
"name": "E-commerce (WooCommerce)",
"plugins": ["woocommerce", "woocommerce-payments"],
"themes": ["storefront"]
}
The file name (without .json) is the profile's ID, which can also be passed as wp_set to the WordPress install API together with none for a clean install.
AI assistantβ
Settings for the AI Assistant, the chat users open from the AI button in the OpenPanel header. It answers questions about the panel using the OpenPanel documentation, the user's plan features and the page they're on, and can look things up or make changes in the user's account.
To use it, enable the AI Assistant module on Settings > Modules, add it to the feature sets of the plans that should have it, and set an API key here.
- What the assistant can do:
- Answer questions only: it can't see the user's data, it only explains how to do things.
- Answer questions and look up account data (default): it can list domains, websites, email accounts, usage and similar, but can't change anything.
- Answer questions, look up data and make changes: it can also add, edit and remove things, after the user approves each change.
- Provider: OpenRouter, OpenAI, Anthropic (Claude), or Custom for any OpenAI-compatible API such as Ollama.
- API key: The key from your provider. Optional for Custom providers that don't need one.
- Model: Model name, for example
gpt-5-mini. Leave empty to useopenrouter/autowith OpenRouter orclaude-opus-5-5with Anthropic. Required for OpenAI and Custom. - API base URL: Only for Custom, the URL that serves
/chat/completions, for examplehttp://ollama:11434/v1. - Assistant name: Shown at the top of the chat. Defaults to AI Assistant.
- Requests per user per month: How many questions each user can ask per month,
0for unlimited. Default is 100. - Max tokens per answer: Upper limit for the length of each answer. Default is 2048.
- Extra instructions: Added to the assistant's instructions, for example your support email or policies.

Actionsβ
The assistant uses the same actions as the OpenPanel API, but only those for features on the user's plan, and every action goes through the same checks as the API. Logins, account email and password changes, 2FA, passkeys, sessions, MCP tokens, the MySQL root password, autologin links, downloads and uploads are never available to it.
- Looking things up runs right away.
- Changes are shown to the user as a card with the exact values, and run only after they click Approve. Users can click Always allow to skip the card next time for the same kind of action.
- Actions that delete or overwrite data, like removing a domain, deleting files, restoring backups or changing passwords, always ask and can't be set to Always allow.
- After the assistant reads content others can write, like files or logs, every change asks again for the rest of that question, even if the user set it to Always allow. This stops text hidden in a file from triggering changes.
- Each question can run at most 12 actions.
Everything the assistant does is written to the user's activity log, for example used the AI Assistant to run: Add a new domain (POST /api/domains {"domain":"example.com"}), approved by the user. Passwords and other secrets are hidden.
Usageβ
Below the settings, Usage this month lists every user who used the assistant this month, with the number of questions, actions, input and output tokens, and when they last used it. Tokens are what your provider bills for, so this shows who uses the assistant most and what it costs you.
The settings are saved in the [AI] section of /etc/openpanel/openpanel/conf/openpanel.config. OpenPanel needs a restart to use the new values.
Each question sends the matching parts of the documentation along with the conversation to the provider, and every action adds another call, so API usage is billed by your provider. Use Requests per user per month to keep costs in check.