Skip to content
Volodymyr edited this page Mar 7, 2026 · 1 revision

How to interact with AWS

If you don't have the AWS CLI utilities installed, download them from here.

All utilities assume that the name of the AWS profile is r2, so to set up the profile, run aws configure --profile r2. It will prompt you for the access key ID and the secret key, they'll be given to you by the admins. Leave the default region name and the default output format as None (default, do not enter anything else).

You'll also need the endpoint url, it'll also be given to you by the admins.

To upload a single file, you can use the following command:

aws s3 cp file s3://worldstage/ --endpoint-url endpoint_url --profile r2

Where file is the path to the file and endpoint_url is the endpoint url provided to you.

To upload a whole folder, use the following command:

aws s3 cp folder s3://worldstage/ --endpoint-url endpoint_url --profile r2 --recursive

Where folder is the path to the folder

NOTE: if you're uploading one of our fake mov-but-actually-mp4 files, make sure you add --content-type "video/mp4" as some browsers will not play the video otherwise.

Clone this wiki locally