AWS CLI quickstart

The AWS CLI works with Filebase out of the box — set the endpoint to s3.filebase.io, set the region to auto, and every command you already know continues to work.

Prerequisites

• A Filebase account.
• An access key pair.
• The AWS CLI installed locally. (install instructions)

Configure the CLI

Run aws configure and respond to the prompts:

$ aws configure
AWS Access Key ID [None]: <your-filebase-access-key>
AWS Secret Access Key [None]: <your-filebase-secret-key>
Default region name [None]: auto
Default output format [None]: json

Your credentials are now stored in ~/.aws/credentials. The endpoint URL is the only thing the CLI doesn't persist between commands — pass it with --endpoint on every call.

tip

To avoid retyping the endpoint, set a shell alias:

alias aws-fb='aws --endpoint https://s3.filebase.io'

Now aws-fb s3 ls lists your Filebase buckets.

Verify the configuration

aws --endpoint https://s3.filebase.io s3 ls

If your credentials are correct you'll see a list of your buckets (or no output, if you haven't created any yet).

Create a bucket

aws --endpoint https://s3.filebase.io s3 mb s3://quickstart-demo

make_bucket: quickstart-demo

Upload an object

Create a small text file and upload it:

echo "hello from filebase" > hello.txt
aws --endpoint https://s3.filebase.io s3 cp hello.txt s3://quickstart-demo/hello.txt

upload: ./hello.txt to s3://quickstart-demo/hello.txt

List objects

aws --endpoint https://s3.filebase.io s3 ls s3://quickstart-demo/

2026-05-01 12:00:00         20 hello.txt

Download an object

aws --endpoint https://s3.filebase.io s3 cp s3://quickstart-demo/hello.txt downloaded.txt

Sync a directory

aws --endpoint https://s3.filebase.io s3 sync ./local-folder/ s3://quickstart-demo/uploads/

sync only transfers files that have changed, making it ideal for backup workflows or static-site deployments.

Delete an object

aws --endpoint https://s3.filebase.io s3 rm s3://quickstart-demo/hello.txt

Delete a bucket

A bucket must be empty before it can be deleted:

aws --endpoint https://s3.filebase.io s3 rb s3://quickstart-demo --force

What's next

• Multipart upload for large files (>5 GB)
• Pre-signed URLs — share an object without sharing your keys
• Switch to an SDK
• The full AWS CLI integration guide