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) |