Configuration

Configuration

Detailed description of all configuration options for the Server Sync plugin.


Default Configuration

The file config/server-sync.php defines the default values:

Key Type Default Description
enforce_same_egg bool true Only servers with the same Egg can be paired
max_sync_pairs_per_server int 3 Maximum sync pairs per server (global limit)
default_interval_minutes int 60 Default sync interval for new pairs
min_interval_minutes int 1 Minimum allowed sync interval
max_file_size_mb int 5120 Maximum archive size in MB
log_retention_days int 30 Days until automatic log cleanup
concurrent_sync_limit int 3 Maximum concurrent running syncs

Admin Plugin Settings

Via Admin → Plugin Settings → Server Sync, all default values can be overridden. Values are stored in the server_sync_settings table as key-value pairs and cached for 1 hour.

Database Settings Override

On ServiceProvider boot, database values are loaded and override config() defaults:

DB Key Config Key Type
enforce_same_egg server-sync.enforce_same_egg bool
max_sync_pairs_per_server server-sync.max_sync_pairs_per_server int
default_interval_minutes server-sync.default_interval_minutes int
min_interval_minutes server-sync.min_interval_minutes int
max_file_size_mb server-sync.max_file_size_mb int
concurrent_sync_limit server-sync.concurrent_sync_limit int
log_retention_days server-sync.log_retention_days int

Sync Directions

Direction Description Steps
Main → Sub Unidirectional sync from main to sub server 1 step
Sub → Main Unidirectional sync from sub to main server 1 step
Bidirectional Sync in both directions (Main takes priority) 2 steps: Main→Sub, then Sub→Main

Sync Scope

Scope Description
Full Directory Synchronize the entire server directory
Selected Paths Only selected paths (configurable via TagsInput or File Browser)

Sync Modes

Mode Description
Live Files are synchronized immediately while servers are running
On Restart Servers are stopped before sync and restarted afterward

Cache Keys

Key TTL Description
server_sync_settings 1 hour All plugin settings from DB
_ss_env 1 hour Plugin environment status
server_sync_schedule_{pairId} 10 minutes Schedule lock (prevents double execution)