Storage Buckets

A bucket is a place to keep files: images, PDFs, uploads from your users, exports, backups, or anything else your application needs to store. You create buckets in the Kuberns dashboard, and you can reach them from your own code with a credential.

Every file is private by default. You choose which files to share.
Share a file with a link that works in any browser, either a permanent link for a public file or a temporary link for a private one.
Upload and download from the dashboard, or from your application with a plain HTTP request. There is no SDK to install and no AWS account to set up.

Who can use buckets

Storage Buckets are available on paid accounts. Accounts on the free trial cannot create buckets.

To create your first bucket, at least one of your services must be running. This keeps storage tied to accounts that are actually deploying something. Once you have a bucket, you can create more, and stopping your services later does not affect the buckets you already have.

Limits


Total storage	No cap
Buckets per account	50
File size in the dashboard	1 GB per file
Credentials per account	5
Region	Mumbai (`ap-south-1`)

Pricing

Storage costs $0.50 per GB per month, charged from your credits. You pay for what you store, hour by hour, and downloads are not billed separately. See Pricing and billing for how the charge is calculated and what happens if your credits run out.

In this section

Create and Manage BucketsCreate a bucket, upload and organise files in folders, download them, and delete files or a whole bucket.Share Files and LinksKeep files private, make a file public, and copy a link that opens in any browser.CredentialsCreate a credential to read and write your buckets from your own application, choose between read-only and read-and-write access, and revoke it when you no longer need it.Use Buckets from Your ApplicationAuthenticate with a credential and read and write your buckets over HTTP from any language.API ReferenceThe address, authentication, access levels, response formats, and endpoint list that every Storage Buckets endpoint shares.Buckets APICreate, list, get, and delete buckets, and create folders, with every parameter, status code, example, and response field.Files APIUpload, download, inspect, delete, and list files, with every parameter, status code, example, and response field.Sharing APIRead and change whether a file is public or private, and get a permanent or temporary link to it, with every parameter, status code, example, and response field.Code ExamplesA ready-made Python client and a JavaScript client for Storage Buckets, with examples for every endpoint.LimitsThe most buckets, credentials, and list results you can have, and the rules for bucket names and file names.PaginationRead a long list one page at a time with limit, page, has_next, and next_page.Rate limitsWhether the Storage Buckets API limits how many requests you can send, and how your code should retry when a request fails.Pricing and BillingHow Storage Buckets are charged, where to see what you owe, how they appear on your monthly bill, and what happens if your credits run out.Errors and TroubleshootingWhat each Storage Buckets error status means and how to fix it.ChangelogChanges to the Storage Buckets API, newest first.