Skip to main content
Blob Storage is Vertra Cloud’s object storage for files your application handles but does not build: user uploads, images, videos, exports and backups. Files are stored once, served from a global CDN, and managed through the API, the SDKs, the dashboard or any S3-compatible tool. It is separate from your application’s own disk. Anything you store here survives redeploys and is not counted against the application’s storage.

​
How it works

  1. Your code calls the API with an API key (or a browser uses a short-lived upload token).
  2. Files up to 100 MB can go in a single request. Larger files, up to 10 GB, are sent straight to storage with a signed URL, so the bytes never pass through the API. See Uploads.
  3. The file is served from the global CDN through a stable public URL, or through a temporary link when it is private.

​
Public and private files

Every file is either public or private, and new files are private unless you say otherwise. You can switch a file between the two at any time without changing its id. Details in Links and visibility.

​
Safe by default

  • Blocked file types. Executables and installers are refused: exe, msi, dll, bat, cmd, com, scr, ps1, apk, dmg, pkg, deb, rpm, appimage and a few others. Files that are really executables are rejected even when renamed.
  • HTML, SVG and XML are always downloads. Files ending in .html, .htm, .svg, .xml or .xhtml are always served as a download, never rendered in the browser, so a user upload cannot run as a web page on your files’ address.
  • Content type from the extension. The platform sets the content type itself, so it cannot be spoofed at upload time.
  • Other accounts’ files never leak. Asking for a file id that is not yours answers “not found”.

​
Cache

Public files are cached by the CDN. Set cache_control per file or per folder to immutable or max-age=N. The no-cache mode is available on the highest Enterprise tiers; see Limits and quotas. Overwriting or deleting a public file clears its cached copy.

​
What is included

Uploads

Simple, direct and resumable multipart uploads.

Sharing

Share pages with expiry, download limits and a password.

Folder rules

Defaults and limits per folder.

Image transformations

Resize and convert through the URL.

S3 compatibility

Use aws-cli, rclone or boto3.

Custom domains

Serve files from your own subdomain.

​
FAQ

Every paid plan, starting at 1 GB on Economy. The Free plan doesn’t include it. The full table is in Limits and quotas.
10 GB per file. Files above 100 MB use the direct upload flow.
The public URL is built from the file’s path. Moving a file changes its path (and URL) but keeps its id, so store the id if you need a stable reference.
They stay for 72 hours in a grace period and are then permanently deleted, without a backup. See Limits and quotas.
Next: the Quickstart.