Permissions & Security
Permissions & Security
Overview of the Server Sync plugin's permission system.
Admin Panel
- Root admin required for access to
/admin/server-sync
- All actions (Create, Edit, Delete, Sync Now, Create Schedule) root admins only
Server Panel
3-tier permission system via subuser permissions:
| Permission |
Allows |
server-sync.view |
View sync page, inspect pairs and logs |
server-sync.manage |
Edit, create, delete sync pairs |
server-sync.trigger |
"Sync Now" button for manual triggering |
Server owners automatically have all permissions.
Per-Server Limit
- Configurable per server via
server_sync_limit column
0 = Server Sync completely disabled (page not visible, permissions not shown)- Limited by global maximum (
max_sync_pairs_per_server)
- Effective limit:
min(server.server_sync_limit, config.max_sync_pairs_per_server)
Validation Checks
Pair Creation
| Check |
Error Message |
| Same server |
Servers cannot be synced with themselves |
| Different eggs (if configured) |
Servers have different egg types |
| Duplicate pair |
This sync pair already exists |
| Server limit 0 |
Server Sync is disabled for this server |
| Server limit reached |
Maximum number of sync pairs reached |
Sync Execution
| Check |
Error Message |
| Already running |
A sync is already running for this pair |
| Server offline / not installed |
Server is not reachable |
| Server in conflict state |
Server is being transferred or restored |
| Node unreachable |
The Wings Daemon is not reachable |
ExecuteSyncJob
| Property |
Value |
| Queue |
database |
| Timeout |
20 minutes |
| Retries |
1 (no retry) |
After completion, a database notification is sent to the triggering user:
| Status |
Color |
Message |
| success |
Green |
Sync completed successfully |
| partial |
Yellow |
Sync partially successful |
| failed |
Red |
Sync failed |