Upload Limits
SkySend provides several configuration options to control upload behavior. All variables are documented in the Environment Variables reference.
Maximum File Size
FILE_MAX_SIZE controls the maximum allowed upload size (default: 2GB). Supports units: B, KB, MB, GB.
Reverse Proxy
If using a reverse proxy (Nginx, Caddy, etc.), make sure its upload size limit matches or exceeds FILE_MAX_SIZE. For Nginx, set client_max_body_size.
Maximum Files Per Upload
FILE_MAX_FILES_PER_UPLOAD limits the number of files per upload (default: 200). Several files go up as one zip, which the browser writes while the upload runs, without compression. FILE_MAX_SIZE applies to that zip, which is a little larger than the files together, not to individual files.
The names of all files travel in the encrypted metadata, and the server takes at most 75,000 bytes of it. A selection of many files with very long names can reach that before it reaches the file limit, and the upload page says so before anything is sent.
Expiry Options
FILE_EXPIRE_OPTIONS_SEC controls which expiry times users can select, as a comma-separated list of seconds (default: 300,3600,86400,604800). FILE_DEFAULT_EXPIRE_SEC sets the pre-selected default and must be one of those values.
Download Limits
FILE_DOWNLOAD_OPTIONS controls which download limits users can select (default: 1,2,3,4,5,10,20,50,100). FILE_DEFAULT_DOWNLOAD sets the pre-selected default and must be one of those values.
How Limits Are Enforced
- The frontend fetches server limits via
GET /api/configon load - Upload options in the UI are restricted to server-configured values
- The server validates all headers against configured limits during upload
- Uploads exceeding
FILE_MAX_SIZEare rejected before writing to disk Content-Lengthheader must match the actual body size