Topic
Servers & storage
Storage nodes, transfers, SFTP operations, backups.
Guides
Articles
Step-by-step write-ups for this topic.
- 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).View article
- How to install external remote storageStep-by-step guide to add a second VPS as remote storage for XFile Ultra — package, install, connect, then performance mode, weight, and the other server options.View article
- Manage the local storage serverEdit the built-in Local Server: name, disk cap, status, targeting, Test storage, and SFTP. Path is UPLOAD_DIR.View article
- Disk caps and offline serversMax disk (GB) blocks new uploads via catalog bytes; Off/unhealthy servers skip upload pick and can show Temporary offline.View article
- Provision a remote storage server (token + package)Create a remote row, download xfileultra-storage.zip, and get a one-time registration token (7-day TTL).View article
- Install a storage node on a second VPSUnzip the package on a second VPS and run buyer-setup.sh (Node, nginx HTTPS, systemd xfileultra-storage).View article
- Connect and enable the storage nodeRegister via /install (Test & connect). Success sets setupStatus connected, Status On, and enables the node.View article
- Direct upload on remote nodesRemote Performance mode (directDownloadEnabled) sends browser uploads to the node via signed HTTPS /u/{token}.View article
- Direct download on remote nodesSame remote Performance mode toggle; downloads use signed /d/{token} on the node (TTL default 900s).View article
- SFTP on storage nodesPer-server SFTP ingest: host/port, sftp-incoming staging, cap 50. Also needs site/env and SFTP mod gates.View article
- Add a CDN server (providers overview)Create an S3-compatible CDN row: AWS, Wasabi, R2, Contabo, DigitalOcean Spaces, IDrive e2, or Other.View article
- CDN credentials and test connectionSave encrypted keys; Test connection runs HeadBucket and may flag CORS for Performance mode.View article
- CDN custom domain / public URLOptional https custom domain for signed downloads. Not available for Other provider.View article
- CDN CORS for browser uploadsWith Performance mode on, browser PUT needs bucket CORS. Panel shows for R2, AWS, IDrive, DigitalOcean after test.View article
- CDN Performance modeDirect S3 upload/download via presigned URLs (default ON). Proxy mode enforces speed/resume limits on the main app.View article
- Transfer queue — move files between serversQueue up to 200 files per batch; workers copy via the main app, verify, then remove the source. Weight is not used.View article
- Server trash, restore, purgeSoft-delete storage servers; restore status; permanent purge removes DB links only - not remote/CDN blobs. Local protected.View article
- Admin manage filesSite-wide file admin: search, filters, bulk visibility/premium/trash, edit metadata, queue transfers (max 200).View article
- Admin files trashRestore or permanently delete soft-deleted files inside trash_keep retention (default 30 days).View article
- Latest downloadsAudit DownloadSession rows (active/completed/failed). Default window last 30 days; file-scoped shows all time.View article