Permissions & Security
Eranio
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_limitcolumn 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 |