Transfer queue — move files between servers
Queue up to 200 files per batch; workers copy via the main app, verify, then remove the source. Weight is not used.
Transfer queue — move files between servers
Move existing files from one backend to another without re-uploading by users.
Where to find it
Admin → Servers → Move files between servers panel; queue at /admin/servers/transfer-queue. Also Transfer... from Admin manage files.
How it works
Pick From / To, filters (count / total size / fill-up-to; order by size/id/popularity; download-count slider), then queue (UI max 200 files per batch). Statuses: queued / running / done / failed (UI also shows Stuck).
Workers copy bytes through the main server (not direct CDN↔CDN), verify size, update file.serverId, then delete the source. Local→local can be metadata-only (no byte copy). Server Weight is for new uploads only - transfers ignore it.
Queue actions: Release stuck, Clear queued, Retry failed. Stuck running jobs requeue after ~10 minutes; abandon after ~2 hours.
Common problems
Jobs sit Queued forever
Background workers inactive - check Health Center and restart workers if needed (FILE_TRANSFER_WORKER_DISABLED kills the worker).
Destination will not receive
Target is Read-only (non-CDN), Off, unhealthy, trashed, or over disk cap.