Skip to main content

Create your first bucket

A bucket is a container for your objects, just like in AWS S3. Buckets are private by default and can be made public if you want their contents accessible over the open internet.

From the Filebase Console​

  1. Sign in to console.filebase.com.
  2. Click Buckets in the left navigation.
  3. Click Create Bucket in the top-right corner.
  4. Enter a bucket name and choose its access level (private or public).
  5. Click Create Bucket.

That's it. Your bucket is ready to receive objects.

Bucket naming rules​

Bucket names must:

  • Be between 3 and 63 characters long.
  • Contain only lowercase letters, numbers, and dashes (-).
  • Start and end with a letter or number.
  • Be globally unique across all Filebase accounts.

These rules match the AWS S3 bucket naming rules, so any name that's valid for AWS S3 is valid for Filebase.

From the AWS CLI​

If you've already generated an access key and configured the AWS CLI:

aws --endpoint https://s3.filebase.io s3 mb s3://my-first-bucket

You should see:

make_bucket: my-first-bucket

From an SDK​

AWS SDK for JavaScript v3
import { S3Client, CreateBucketCommand } from '@aws-sdk/client-s3';

const s3 = new S3Client({
  endpoint: 'https://s3.filebase.io',
  region: 'auto',
  credentials: {
    accessKeyId: process.env.FILEBASE_KEY!,
    secretAccessKey: process.env.FILEBASE_SECRET!,
  },
});

await s3.send(new CreateBucketCommand({ Bucket: 'my-first-bucket' }));
AWS SDK for Python (boto3)
import boto3

s3 = boto3.client(
    's3',
    endpoint_url='https://s3.filebase.io',
    region_name='auto',
    aws_access_key_id='YOUR_KEY',
    aws_secret_access_key='YOUR_SECRET',
)

s3.create_bucket(Bucket='my-first-bucket')

Public vs. private​

By default, every bucket is private: only requests authenticated with your access key can read from it. To make a bucket public — typically because you want to serve assets directly to a browser — set its ACL to public-read at creation time, or call PutBucketAcl afterwards.

See Public vs. private buckets for the full breakdown of when to use each.

Next steps​