Servers configuration settings
| Key | Type | Description |
|---|---|---|
server_allow_egg_change |
select | Allow users to change the server spells/eggs |
server_allow_startup_change |
select | Allow users to change the server startup |
server_allow_custom_docker_image |
select | Allow users to enter a custom Docker image on the startup page. When disabled, users may only select images configured on the spell. |
server_allow_subusers |
select | Allow users to add subusers to their servers |
server_allow_schedules |
select | Allow users to create and manage schedules for their servers |
server_lifecycle_hooks_enabled |
select | Show the Lifecycle Hooks page in server navigation and allow configuration. Uses the same schedule permissions as tasks (schedule.read / schedule.update). When disabled, the menu entry is hidden, hooks do not run on power actions or server crashes, and API changes are rejected. Independent of schedules: you can enable hooks without enabling cron schedules. |
server_lifecycle_hooks_container_shell_enabled |
select | Allow Container Shell lifecycle hook steps and Container Shell schedule tasks (docker exec /bin/sh -c inside the server container). This is a security-sensitive capability: users with schedule.update (and control.console for schedule tasks) can run arbitrary shell commands in running containers when hooks fire or schedules run. Default off. Lifecycle hook steps additionally require Lifecycle Hooks Enabled; schedule tasks additionally require Schedules to be allowed. Existing Container Shell steps and tasks will not execute while this is disabled. |
server_run_script_enabled |
select | Allow the "run a custom container script" endpoint, which runs an arbitrary script inside a spell-allowed Docker image. Separate from the lifecycle Container Shell setting. Security-sensitive capability, default off. |
server_backup_retention_mode |
select | Default backup retention when limit is reached (servers/VMs can override per entity). Hard limit blocks new backups. FIFO rolling removes the oldest eligible backup to make room. |
server_allow_user_backup_policy_edit |
select | Allow server owners to change backup retention mode (inherit / hard limit / FIFO) from the panel and user API. Backup slot count (backup limit) is admin-only. Admins can always edit servers and VM instances. |
server_allow_allocation_select |
select | Allow users to select which allocation to assign when auto-allocating |
server_allow_user_made_firewall |
select | Allow users to create and manage their own server firewall rules |
server_allow_user_made_proxy |
select | Allow users to create and manage their own server reverse proxy configurations |
server_proxy_max_per_server |
number | Maximum number of reverse proxy configurations per server |
server_allow_cross_realm_spell_change |
select | Allow users to change server spells/eggs across different realms. When disabled, users can only select spells from the same realm as their server. |
server_allow_user_server_deletion |
select | Allow users to delete their servers. When disabled, users can only delete their servers via the admin panel. |
server_allow_user_made_import |
select | Allow users to import server files from remote SFTP or FTP servers. The server must be offline for imports to work. |
server_allow_user_made_fastdl |
select | Allow users to create and manage their own FastDL configurations |
server_allow_user_made_subdomains |
select | Allow users to create and manage server subdomains |
server_auto_start_on_node_reconnect |
select | When a game node reconnects after reboot or downtime, automatically start servers that have Auto Start enabled (skips manually stopped and suspended servers). Configure stagger delays below instead of Wings YAML. |
server_auto_start_stagger_seconds |
number | Seconds between each auto-started server on the same node after reconnect. Prevents starting every server at once. |
server_auto_start_initial_delay_seconds |
number | Seconds to wait after Wings reconnects before starting the first auto-start server (gives Docker time to settle). |
server_allow_user_auto_start |
select | Allow server owners to toggle Auto Start after node reboot from the server settings page. Admins can always configure this per server. |
server_hide_ips |
select | Hide IP addresses in server activity logs and other views. When enabled, IPs will be masked with "***.***.***.***" to protect user privacy. |
file_trash_enabled |
select | Enable a trash bin for server file deletions. Deleted files are moved to trash instead of being permanently removed, and users can restore or empty trash from the file manager. |
file_trash_max_size_mb |
number | Maximum total size of trashed files per server, in megabytes. When exceeded, the oldest trashed items are permanently deleted. Use 0 for no size limit. |
file_trash_retention_days |
number | Automatically purge trashed files older than this many days. Use 0 to keep items until manually deleted or the size limit is reached. |