Storage

Storage workflow

Every file uploaded to your account goes to Fileboy storage, with all media processing and delivery and caching processed through it.

The workflow with Fileboy storage is as follows:

• A file is uploaded to one of your Fileboy apps, identified by the apps public key
• The file goes into storage
• If your app is set to "Automatic File Storing" - the file is stored forever, otherwise it is set to be removed after 24 hours.
• If you have "Automatic File Storing" disabled, you can make an API call to manually store the file.
• Files are then delivered to users via our CDN when requested.
• If the file is an image, transforms can be made during this request.
• Any transform requests cause a new additional cached version of the image to be stored, speeding the next request and lowering the amount of transformations carried out by your Fileboy app.

How storage is counted

Your plan's storage limit is measured against every byte your app stores, not only the files you uploaded. Each stored file counts once, under one of these kinds:

• Images and other files: what you uploaded.
• Video originals: the file uploaded for each video.
• Video renditions: the streaming versions made at each quality.
• Video posters and captions: generated and custom posters, caption and transcript files.
• Image transform cache: the resized and converted copies kept so repeat requests are fast, including copies of posters.
• Other generated files: anything else Fileboy made for your app.

Deleting a file also deletes its cached copies, and deleting a video deletes its renditions, posters and captions.

Each app's Storage page in the dashboard shows the total against your plan, the split by kind, your biggest files and videos, and one total a day so you can see it grow. Daily totals are recorded just after midnight UTC, starting from when the feature went live; earlier days are not filled in. Read the same numbers from your server with GET /usage/storage.

The dashboard warns you, and emails you, at 80% and 100% of your storage limit by default. See usage alerts to change when and how.