Docs Ordnary Web Services Ordnary R2
Quickstart
Create a bucket, generate the access key and upload your first file with the AWS CLI, JavaScript or Python.
1. Create a bucket
- 1
Open Ordnary R2
In the console's drawer choose Ordnary R2, then Buckets, then Create bucket. The Getting started page has presets if you want a head start.
- 2
Name it
3 to 63 characters, lowercase letters, digits and hyphens. The name is permanent.
- 3
Keep the defaults
Automatic location, Standard storage class, private. You can change the class and public access later; the location is permanent.
- 4
Create
The bucket is ready immediately.
2. Generate the access key
On the Buckets page, under S3 API access, choose Generate access key. Copy the endpoint, the access key ID and the secret; the secret is shown once. Put them in your environment:
AWS_ACCESS_KEY_ID=<access-key-id>
AWS_SECRET_ACCESS_KEY=<secret-access-key>
AWS_ENDPOINT_URL_S3=https://s3.ordnary.com
3. Upload a file
aws s3 cp ./report.pdf s3://my-bucket/reports/report.pdf
aws s3 ls s3://my-bucket/reports/
# Without AWS_ENDPOINT_URL_S3 in the environment:
aws s3 cp ./report.pdf s3://my-bucket/reports/report.pdf --endpoint-url https://s3.ordnary.comimport { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
const r2 = new S3Client({
region: "auto",
endpoint: "https://s3.ordnary.com",
forcePathStyle: true,
credentials: {
accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
},
});
await r2.send(new PutObjectCommand({ Bucket: "my-bucket", Key: "hello.txt", Body: "Hello from Ordnary R2" }));import boto3
from botocore.config import Config
r2 = boto3.client(
"s3",
endpoint_url="https://s3.ordnary.com",
region_name="auto",
config=Config(s3={"addressing_style": "path"}),
)
r2.upload_file("report.pdf", "my-bucket", "reports/report.pdf")4. Check
$ aws s3 ls s3://my-bucket/reports/2026-10-25 14:02:11 184320 report.pdf
The object also shows in the console under the bucket's Objects tab, where you can browse, upload and delete without any tool.