Appearance

Object Storage ​

Object Storage lets your project use an S3-compatible storage service (for example MinIO) to store files such as user uploads, media, and backups outside of your application server.

Enabling Object Storage ​

Object Storage is an add-on service and is not enabled by default. For now, our support team sets up the storage endpoint, buckets, and credentials for your project. Self-service management is on our roadmap, but isn't available yet.

INFO

To use Object Storage for your project, please contact our support team with your project ID and a brief description of your use case. Our team will grant your project access to an endpoint, create the buckets you need, and issue credentials for them.

If you need an additional bucket or a new set of credentials later on, please contact support again.

Viewing your configuration ​

Once Object Storage has been set up for your project, you can view your configuration under Services > Object Storage.

Your project can be connected to more than one storage endpoint. For each connection, you'll see:

  • The endpoint it connects to, including its URL, region, and addressing style
  • A Buckets table listing every bucket on that connection, its optional base URL, and which credential sets can be used to access it
  • A Credentials table listing every credential set on that connection, its access key and secret key, and which buckets it can access

Copy the access key, secret key, endpoint URL, and bucket name into your application's S3 client configuration to start using the bucket.

WARNING

Addressing style matters when configuring your S3 client: most non-AWS S3-compatible servers (such as MinIO) require path-style addressing (https://s3.example.com/bucket), while AWS S3 itself uses virtual-hosted-style (https://bucket.s3.example.com). Check the addressing style shown for your endpoint and configure your client accordingly.