The Settings page in the Admin area lets you control every aspect of the panel that is configurable at runtime. Changes take effect immediately after you click Save — no restart is required. Navigate to Admin → Settings to get started.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/calagopus/panel/llms.txt
Use this file to discover all available pages before exploring further.
Application settings
General settings that affect the panel’s branding and behavior.Name
Name
The display name of your panel instance. This appears in the browser title bar and in email notifications. Maximum 64 characters.
Language
Language
The default locale used for new users and for the admin UI. This is a BCP 47 language tag (for example,
en or de). Users may override this individually if Allow changing language is enabled under user settings.Icon and banner
Icon and banner
URL
URL
The canonical public URL of your panel — for example,
https://panel.example.com. This is used to construct redirect URLs and links in emails. It must be a valid URL.Two-factor authentication requirement
Two-factor authentication requirement
Controls which users are required to have 2FA enabled before they can log in:
| Option | Effect |
|---|---|
| None | 2FA is optional for all users |
| Admins | Only users with admin access must enroll |
| All users | Every user must enroll before accessing the panel |
Session cookie and duration
Session cookie and duration
Registration
Registration
When enabled, anyone can create an account at the login page. When disabled, accounts must be created by an admin via Admin → Users or the CLI. You will be asked to confirm before enabling registration if no CAPTCHA is configured.
Telemetry
Telemetry
Allows Calagopus to send anonymous usage data to help improve the project. No personally identifiable information is included. You can preview the exact payload before sending by clicking Preview Telemetry.
WebAuthn settings
These settings control passkey and hardware security key support.Relying party ID (RP ID)
Relying party ID (RP ID)
The domain your panel is served from, without a scheme or port — for example,
panel.example.com. This must match the domain in the browser’s address bar exactly. Changing this value after users have enrolled passkeys will invalidate those credentials.Relying party origin (RP origin)
Relying party origin (RP origin)
The full origin URL including scheme — for example,
https://panel.example.com. Must be a valid URL.Server settings
Limits and permissions that apply to servers and their file managers.File manager view size
File manager view size
Maximum size in bytes of a file that can be viewed in the in-browser file editor. Files larger than this limit show a download prompt instead.
File manager content search size
File manager content search size
Maximum size in bytes of a file that participates in in-browser content search.
File manager search results
File manager search results
Maximum number of results returned by a file manager search query.
Subuser count
Subuser count
Maximum number of subusers (co-owners) that can be added to a single server.
Schedule step count
Schedule step count
Maximum number of steps allowed in a single server schedule.
Allow overwriting custom Docker image
Allow overwriting custom Docker image
When enabled, users can override the Docker image specified by the egg with a custom image string.
Allow viewing installation logs
Allow viewing installation logs
When enabled, users can view the output of a server’s installation script while it runs.
Allow viewing transfer progress
Allow viewing transfer progress
When enabled, users can see live progress when a server is being transferred between nodes.
User settings
Limits that apply to user accounts panel-wide.Max server group count
Max server group count
Maximum number of server groups a user can create.
Max API key count
Max API key count
Maximum number of API keys a user can hold at one time.
Max command snippet count
Max command snippet count
Maximum number of saved command snippets per user.
Max security key count
Max security key count
Maximum number of WebAuthn security keys (passkeys) a user can register.
Max SSH key count
Max SSH key count
Maximum number of SSH public keys a user can store.
Allow changing language
Allow changing language
When enabled, users can override the panel’s default language from their account settings.
Activity log settings
Control how long activity logs are retained and what gets logged.Admin log retention
Admin log retention
How long (in days, 1–3650) admin activity records are kept. You can also set an optional maximum record count; when both limits are set, whichever is reached first causes older records to be pruned.
User log retention
User log retention
Same retention controls as admin logs, applied to user-level activity events.
Server log retention
Server log retention
Retention for server activity events. Additionally:
- Log admin activity on servers — records actions taken by admins in the server context.
- Log schedule activity — records when scheduled tasks run.
CAPTCHA settings
CAPTCHA challenges protect the registration and login forms from automated abuse. Select a provider from the Provider dropdown. When you switch providers, new fields appear for the credentials required by that provider.- None
- reCAPTCHA
- hCaptcha
- Friendly Captcha
- Cloudflare Turnstile
No CAPTCHA challenge is shown. Suitable for panels that restrict registration or are used in private environments.
Rate limit settings
Rate limits protect endpoints from brute-force and abuse. Each endpoint accepts a limit (maximum requests) and a period (window in seconds).| Endpoint | Default protection |
|---|---|
auth_register | New account registration |
auth_login | Password login attempts |
auth_login_checkpoint | 2FA checkpoint |
auth_login_security_key | WebAuthn login |
auth_password_forgot | Password reset requests |
client | General client API requests |
client_servers_backups_create | Backup creation per server |
client_servers_files_pull | Remote file pull requests |
client_servers_files_pull_query | File pull status queries |
Saving settings
Each settings section has its own Save button. Click Save after making changes in a section to apply them. Settings are validated before saving; the form will highlight any invalid fields.You need the
settings.update admin permission to save changes. If the button is disabled, check with your panel owner about your role.