// STORAGE AND FORMS
Object Storage (Spaces)
An S3-compatible bucket per project for uploads, images, and generated files — separate from the database.
A Space is an S3-compatible object storage bucket, one per project, provisioned on demand from the project's Object Storage page — separate from the database, and separate from your plan's project quota. Use it for anything a Postgres row is a bad fit for: images, video, generated files, user uploads.
What you get
- A dedicated bucket with a generated name (
anysites-{id}), plus an access key and secret key shown once you create it. - The endpoint and credentials are S3-compatible — use
@aws-sdk/client-s3,boto3, or any standard S3 client, pointed at the given endpoint rather than AWS. - A
Public URLin the formhttps://{bucket}.{region}.digitaloceanspaces.com.
The bucket itself is created private, matching standard S3/DO Spaces defaults — the
Public URL only serves an object if that specific object was uploaded with a public-read ACL. Set the ACL explicitly on upload (e.g. ACL: "public-read" with the S3 SDK) for anything you intend to link to directly; don't assume everything in the bucket is reachable by URL.Deleting
Deleting a Space empties the bucket first (objects, then the bucket itself) — there's no recovery once that completes. Access keys shown on creation aren't re-displayed elsewhere in the dashboard, so store them (or fetch them again via the project's Dev Prompt) before you need them.