← All settings

Servers

Servers configuration settings

27 keys servers
KeyTypeDescription
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.