Storage backends overview (local vs remote node vs CDN)
Three backend kinds on one Servers list: Local disk, remote storage node, and CDN (S3-compatible).
Storage backends overview (local vs remote node vs CDN)
XFile Ultra stores files on one or more backends that share the same Servers management list.
Where to find it
Admin → Servers → Servers management (/admin/servers)
How it works
| Kind | What it is |
|---|---|
| Local | Disk on the main app VPS (UPLOAD_DIR). Built-in row id srv-local (label Local Server). |
| Remote / storage node | Lightweight node on a second VPS, registered to the master (setupStatus awaiting install or connected). |
| CDN | S3-compatible object storage (AWS, Wasabi, R2, Contabo, DO Spaces, IDrive e2, Other). |
New uploads pick among enabled, healthy, status-On servers using Weight (weighted random; weight floored to at least 1). Existing files stay where they are until you transfer them.
CDN Performance mode (default on when unset) can enable direct S3 presigned uploads for CDN backends.
Common problems
New uploads ignore a server
It must be On, healthStatus ok, connected (remotes), under disk cap, not trashed, and allowed by geo/user targeting.
Weight does nothing
Weight only affects *new* uploads among eligible On servers - not transfers or already-stored files.