pterodactyl_addon/docs/CONFIG.md

Configuration Reference

Ball Studios — https://git.balls.studio/BallStudios/pterodactyl_addon

All settings are in config/advanced-admin.php. Many can be overridden via .env.

Network Traffic Dashboard

Key	Default	.env Override	Description
network.enabled	true	ADDON_NETWORK_ENABLED	Enable/disable module
network.collection_interval_seconds	10	ADDON_NETWORK_INTERVAL	Seconds between metrics collection
network.iptables_enabled	false	ADDON_NETWORK_IPTABLES	Enable port-level iptables collection
network.retention.raw	1	ADDON_NETWORK_RETENTION_RAW	Raw data retention (days)
network.retention.5m	7	ADDON_NETWORK_RETENTION_5M	5-min downsampled retention (days)
network.retention.1h	30	ADDON_NETWORK_RETENTION_1H	Hourly downsampled retention (days)
network.retention.1d	365	ADDON_NETWORK_RETENTION_1D	Daily downsampled retention (days)
network.rate_limit_per_minute	12	ADDON_NETWORK_RATE_LIMIT	Live endpoint rate limit

Role-Based Permissions

Key	Default	Description
roles.enabled	true	Enable/disable module
roles.max_roles_per_server	0	0 = unlimited
roles.warn_on_delete_in_use	true	Warn before deleting assigned role
roles.dangerous_permissions	See config	Permissions that trigger UI warning
roles.write_rate_limit	30	Admin write operations per minute

File Revision History

Key	Default	.env Override	Description
revisions.enabled	true	ADDON_REVISIONS_ENABLED	Enable/disable module
revisions.storage_path	addons/revisions	ADDON_REVISIONS_PATH	Storage path under storage/app/
revisions.max_file_size	10485760 (10 MB)	ADDON_REVISIONS_MAX_FILE_SIZE	Max file size to track (bytes)
revisions.max_revisions_per_file	50	ADDON_REVISIONS_MAX_PER_FILE	Max revisions per file
revisions.max_storage_per_server	524288000 (500 MB)	ADDON_REVISIONS_MAX_STORAGE	Max storage per server
revisions.retention_days	90	ADDON_REVISIONS_RETENTION_DAYS	Delete revisions older than N days
revisions.excluded_patterns	See config	—	File glob patterns to never track

Default Excluded Patterns

.env, *.env, *.key, *.pem, *.p12, *.pfx, *.crt, *.cer, *.jks
secrets.yml, secrets.yaml, *secret*, *password*, *token*
*.sql, *.sql.gz, *.bak, *.backup, *.dump
*.zip, *.tar, *.tar.gz, *.tar.bz2, *.7z, *.rar

Console Autocomplete

Key	Default	.env Override	Description
console.enabled	true	ADDON_CONSOLE_ENABLED	Enable/disable module
console.autocomplete_rate_limit	60	ADDON_CONSOLE_RATE_LIMIT	Requests per minute per user
console.player_cache_ttl_minutes	30	ADDON_CONSOLE_PLAYER_TTL	Player cache expiry (minutes)
console.max_suggestions	10	ADDON_CONSOLE_MAX_SUGGESTIONS	Max suggestions returned
console.patterns.join.*	See config	—	Regex patterns for player join
console.patterns.leave.*	See config	—	Regex patterns for player leave