Storage configured limits
The limits Storage applies to files, buckets, and requests.
File size
| Limit | Value | What happens |
|---|---|---|
| Largest file TaruviBase accepts | 5 GB | A bucket's file size limit can't be set higher. |
| Default bucket file size limit | 50 MB | Uploads larger than the bucket's limit are rejected with 400. Change it with file_size_limit when you create or update the bucket. |
Bucket settings
| Setting | Default | Rules |
|---|---|---|
file_size_limit | 50 MB (52428800 bytes) | Positive number of bytes, up to 5 GB. |
allowed_mime_types | [] (all types allowed) | File types such as image/png; wildcards like image/* work. |
max_size_bytes | None | Optional total size quota. Must be at least file_size_limit. |
max_objects | None | Optional file count quota. |
Quotas
max_size_bytes and max_objects are checked periodically, not on each upload.
When a bucket goes over a quota, it is marked as exceeded — the Console shows a
Quota exceeded warning and the bucket's usage/ endpoint reports it — but
uploads are not blocked. Delete files to bring the bucket back under its quota.
GET /buckets/{slug}/usage/ returns usage as of the last recalculation;
calculated_at shows when that was.
Per-request limits
| Limit | Value | What happens |
|---|---|---|
| Metadata per file | 2 KB total | Rejected with 400 |
| Files per batch upload | 100 | Rejected with 400 |
| Total size per batch upload | 800 MB | Rejected with 400 |
| Paths per batch delete | 100 | Rejected with 400 |
Search limit | Up to 1000 (default 100) | Higher values are rejected with 400 |
Browse page_size | Up to 100 (default 50) | Higher values are reduced to 100 |
List page_size | Up to 100 (default 10) |
SharePoint access
For SharePoint buckets, opening a view or edit link waits up to 8 seconds for SharePoint to grant access. Files of 4 MB or less upload in a single request; larger files upload in chunks automatically.
What isn't limited
- There is no limit on the number of buckets or files per app or site beyond the optional per-bucket quotas.
- Listing, browsing, and searching without signing in is refused, even for public buckets — only individual public files can be downloaded anonymously.
Related pages
- Security and limits — who can perform each action
- Manage buckets — set
file_size_limitand quotas - Troubleshooting — errors caused by these limits