General Settings
Configure core site settings including URL, title, branding, locale, and integrations.
Breadcrumb: System Configuration > General Settings
Overview
General Settings control the fundamental aspects of your PteroCA installation including:
Site identity (URL, title)
Localization (interface language)
Telemetry and data collection
Server lifecycle management (automatic deletion)
Integration with PHPMyAdmin
These settings affect how your panel operates and integrates with other services. Essential general settings can be configured during initial setup via the CLI wizard, with all options available through the Admin Panel.
Settings Overview
Site URL
URL
✓
✓
Base URL of your application with protocol
Site Title
Text
✓
✓
Title displayed throughout the application
Site Locale
Locale
✓
✓
Default interface language
Telemetry Consent
Boolean
✓
Allow anonymous usage data collection
Delete Suspended Servers
Boolean
✓
Auto-delete suspended servers
Days After Suspension
Number
✓
Grace period before deletion
Show PHPMyAdmin URL
Boolean
✓
Display PHPMyAdmin link in menu
PHPMyAdmin URL
URL
✓
URL to PHPMyAdmin installation
Configuration via CLI Wizard
The CLI configuration wizard covers 3 essential general settings during initial setup.
Run the Wizard
Settings Covered
1. Site URL
Prompted during wizard with default value.
Requirements:
Must include protocol (
http://orhttps://)No trailing slash
Must be accessible from the internet (for production)
2. Site Title
Name of your panel displayed in the browser and UI.
Best Practices:
Keep it concise (2-4 words)
Reflects your brand or service
Avoid special characters
3. Site Locale
Default language for the user interface.
Available Locales:
en- Englishpl- Polish (Polski)de- German (Deutsch)de_CH- Swiss German (Schweizerdeutsch)fr- French (Français)es- Spanish (Español)it- Italian (Italiano)pt- Portuguese (Português)nl- Dutch (Nederlands)id- Indonesian (Bahasa Indonesia)cn- Chinese (中文)hi- Hindi (हिन्दी)ru- Russian (Русский)ua- Ukrainian (Українська)
Note: Users can override this in their profile settings.
Configuration via Admin Panel
All 10 general settings can be managed through the Admin Panel.
Access General Settings
Log in to the Admin Panel
Navigate to Settings in the main menu
Click General
Update values
Click Save
Setting Details
Site URL
Setting Code: site_url Field Type: URL Required: Yes Default: http://localhost
The base URL where your PteroCA panel is accessible. This is used throughout the system for:
Generating links in emails
Asset URLs
SSO redirects
Format:
Validation:
Must start with
http://orhttps://No trailing slash allowed
Valid domain or IP address
Impact:
Email links will use this URL
Affects SSO redirects
Best Practices:
Use HTTPS in production
Ensure DNS is properly configured
Match your actual domain exactly
Site Title
Setting Code: site_title Field Type: Text Required: Yes Default: My App Max Length: 255 characters
The title displayed in:
Browser tab
Page headers
Email subjects
Notification titles
Example:
Impact:
Visible throughout the entire application
Used in email subjects and notifications
Displayed in browser bookmarks
Site Locale
Setting Code: site_locale Field Type: Locale (Select) Required: Yes Default: en
Default language for the user interface.
Available Options:
en- Englishpl- Polish (Polski)de- German (Deutsch)de_CH- Swiss German (Schweizerdeutsch)fr- French (Français)es- Spanish (Español)it- Italian (Italiano)pt- Portuguese (Português)nl- Dutch (Nederlands)id- Indonesian (Bahasa Indonesia)cn- Chinese (中文)hi- Hindi (हिन्दी)ru- Russian (Русский)ua- Ukrainian (Українська)
Impact:
Default language for new users
Used in system-generated content
Affects date/time formatting
Controls currency formatting
Note: Individual users can override this in their account settings.
Telemetry Consent
Setting Code: telemetry_consent Field Type: Boolean (Toggle) Required: No Default: true
Allow sending anonymous usage data to help improve PteroCA.
Data Collected:
Installation events (install, update)
Error occurrences (without sensitive data)
PteroCA version
PHP version
NOT Collected:
Personal data
API keys
URLs
User information
Server configurations
Purpose:
Identify common errors
Prioritize bug fixes
Understand version adoption
Improve software quality
Privacy:
Completely anonymous
No tracking of individual installations
No personally identifiable information
Can be disabled at any time
When Disabled:
No data sent to PteroCA servers
Full functionality maintained
No impact on performance
Delete Suspended Servers Enabled
Setting Code: delete_suspended_servers_enabled Field Type: Boolean (Toggle) Required: No Default: false
Automatically delete servers that remain suspended beyond configured grace period.
When Enabled:
Suspended servers deleted after X days
Frees up resources automatically
Permanent deletion (cannot be recovered)
Workflow:
Server payment expires
Server suspended immediately
Grace period begins (configured in next setting)
After X days, server permanently deleted from Pterodactyl
Use Cases:
Automatic resource cleanup
Enforce payment policies
Free up allocations and ports
Reduce manual administration
Warning:
Deletion is PERMANENT
All server data lost (files, databases, configurations)
No recovery possible
Ensure clear communication to users in ToS
Best Practices:
Set reasonable grace period (14-30 days recommended)
Send renewal notifications before expiration
Document policy clearly in Terms of Service
Provide backup/export options to users
Delete Suspended Servers Days After
Setting Code: delete_suspended_servers_days_after Field Type: Number Required: Only if auto-deletion enabled Default: 30 Min: 1 day Recommended: 14-30 days
Number of days after suspension before automatic deletion.
Recommended Values:
Strict Policy
7
Quick cleanup, aggressive enforcement
Balanced
14-30
Reasonable grace period
Generous
60-90
Extended opportunity to renew
Considerations:
Legal/Regulatory:
Some jurisdictions may require minimum grace periods
Check local consumer protection laws
Document retention policies
User Experience:
Longer period = better UX, fewer complaints
Shorter period = faster resource recovery
Balance business needs with customer satisfaction
Resource Management:
High demand for resources = shorter period justified
Plenty of available resources = longer period acceptable
Communication:
Send multiple renewal reminders before expiration
Clear warning X days before deletion
Final notice 24-48 hours before deletion
Example Configuration:
Notification Integration: Enable renewal notifications in Email Settings to automatically remind users before suspension.
Show PHPMyAdmin URL
Setting Code: show_phpmyadmin_url Field Type: Boolean (Toggle) Required: No Default: false
Display a link to PHPMyAdmin in the admin menu.
When Enabled:
Link appears in Settings menu
Only visible to users with appropriate permissions
Opens in new tab
Security Considerations:
Ensure PHPMyAdmin is properly secured
Use strong authentication
Consider IP restrictions
Keep PHPMyAdmin updated
PHPMyAdmin URL
Setting Code: phpmyadmin_url Field Type: URL Required: Only if "Show PHPMyAdmin URL" is enabled Default: None
URL to your PHPMyAdmin installation.
Format:
Requirements:
Must include protocol
Should be HTTPS in production
Must be accessible from admin's browsers
Example Configurations:
Same Server:
Separate Subdomain:
Different Port:
Best Practices
Site Identity
Choose a Memorable Title: Your site title is one of the first things users see
Consistent URL: Avoid changing site URL after launch (breaks links)
HTTPS Everywhere: Always use HTTPS in production
Professional Domain: Use custom domain instead of shared hosting subdomain
Localization
Know Your Audience: Set default locale to match your primary user base
Test Translations: Verify UI elements in your chosen locale
Document Languages: Let users know which languages you support
Update Consistently: Keep translations updated when adding features
Server Lifecycle Management
Set Appropriate Grace Period: Balance business needs with user experience (14-30 days recommended)
Clear Communication: Document deletion policy in Terms of Service
Multiple Notifications: Send renewal reminders at 7 days, 3 days, and 1 day before expiration
Provide Backups: Allow users to export/download server data before deletion
Monitor Automation: Regularly review auto-deletion logs
Telemetry and Privacy
Transparency: Inform users about data collection in Terms of Service
Respect Choice: Allow disabling telemetry without functionality loss
Keep Anonymous: Never collect personal or sensitive data
Regular Review: Periodically review what data is collected
PHPMyAdmin Integration
Security First: Use strong passwords and IP restrictions
Separate Subdomain: Host PHPMyAdmin on separate subdomain
Regular Updates: Keep PHPMyAdmin updated for security
Limit Access: Only show to administrators who need it
Troubleshooting
Site URL Issues
Problem: Links in emails point to wrong URL
Cause: Site URL not properly configured
Solution:
Verify Site URL in Settings → General
Ensure it matches your actual domain
Clear application cache:
php bin/console cache:clearTest by sending a password reset email
Locale Issues
Problem: UI still shows in English after changing locale
Cause: Translation files not loaded or cache not cleared
Solutions:
Clear application cache:
php bin/console cache:clearVerify locale code is correct (e.g.,
plnotpl_PL)Check if translation files exist for chosen locale
Refresh browser (Ctrl+F5)
Problem: Some text remains in English
Cause: Incomplete translations for selected locale
Solution:
This is normal - not all strings may be translated
Contribute translations if you can
Report missing translations on GitHub
Some third-party plugins may not support all locales
PHPMyAdmin Integration
Problem: PHPMyAdmin link not visible in menu
Cause: "Show PHPMyAdmin URL" is disabled or permission issue
Solutions:
Enable "Show PHPMyAdmin URL" in Settings → General
Set PHPMyAdmin URL
Verify your user has appropriate permissions
Clear browser cache
Problem: PHPMyAdmin link leads to 404 error
Cause: Incorrect URL configuration
Solutions:
Verify PHPMyAdmin URL is correct
Test URL directly in browser
Ensure PHPMyAdmin is installed and accessible
Check web server configuration
Related Settings
Theme Settings - Logo, favicon, colors, MOTD
Email Settings - SMTP and renewal notifications
Pterodactyl Settings - Server lifecycle integration
Access Control - Manage who can modify settings
Additional Resources
CLI Reference - All available CLI commands
Translation Contributing - Help translate PteroCA
Privacy Best Practices - Data protection guidelines
Last updated