Upload files

Documentation Index

Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt

Use this file to discover all available pages before exploring further.

_{Updated May 8, 2026} The fastest way to put files into a bucket is the dashboard’s drag-and-drop uploader. Files upload in the background — you can navigate around the dashboard while they finish — and large files automatically use multipart upload. For programmatic uploads, see Use the S3 SDK.

​

Before you start

• A bucket — see Create a bucket.
• The files you want to upload, on the machine you’re browsing the dashboard from.

​

1. Open the bucket

In Object Storage → Buckets, click the name of the bucket you want to upload into. The bucket detail page opens on the Objects tab by default. The Objects tab is where you’ll spend most of your time:

• Search objects by name
• Create Folder — adds a key prefix (folder-style organization in S3)
• Upload — opens the drag-and-drop dialog
• Each object row has an Actions menu — covered in Manage objects below

​

2. Click Upload

Click the orange Upload button at the top right of the Objects tab. The Upload Files dialog opens. The dialog tells you what’s happening:

• Files upload to the current location in the bucket (root, or whichever folder you’re inside)
• Uploads run in the background — you can navigate away
• Files at or above 10 MB use multipart upload automatically — the dashboard chunks them into 16 MB parts, uploads up to 10 in parallel per file, and assembles on the server. The dialog text rounds this to “100 MB+” for friendliness; the actual threshold is 10 MB

​

3. Drop or browse for files

Two ways to add files to the dialog:

• Drag and drop them onto the dashed zone
• Click the zone to open a file picker

You can drop multiple files at once. Each file gets its own progress bar.

​

4. Confirm

Click Upload N Files. The dialog stays open until uploads start, then you can close it — uploads continue in the background. When uploads finish, the new objects appear in the bucket’s Objects tab with their size and timestamp.

​

Multipart upload, briefly

For any single file at or above 10 MB, the dashboard switches to multipart upload automatically. There’s nothing for you to configure — but it’s worth knowing what it does:

• Splits the file into 16 MB parts by default
• For very large files, scales the chunk size up automatically to stay under the 10,000-part S3 limit (max(16 MB, fileSize / 10000))
• Uploads up to 10 parts in parallel per file; up to 3 files in parallel from the queue
• If a part fails, only that part retries (up to 3 times) — not the whole file
• Assembles parts server-side once they all arrive
• Theoretically supports files up to 5 TiB; in practice browser memory caps hit first

The same mechanic is what every S3 SDK uses on multi-MB-plus files; the dashboard just exposes it transparently.

​

Per-object actions

Once a file is uploaded, opening the row’s ⋮ Actions menu gives you everything you can do with one object:

​

Folders, briefly

S3 doesn’t actually have folders — keys with / in them just look like a hierarchy in the dashboard. The Create Folder button writes a zero-byte placeholder object whose key ends with /, which makes the dashboard render the folder. Inside, all objects share that prefix. You can also create the hierarchy implicitly by uploading a file with a key like 2026/may/report.pdf — the dashboard shows it inside 2026/may/.

​

Bucket Properties: versioning, encryption, tags

The Properties tab on each bucket controls bucket-wide settings: Tags and Default Encryption are visible in the dashboard but disabled — they’ll light up when the features ship. Versioning works today. The bucket also has a Metrics tab — live storage size, request counts, and ingress/egress for the current month. See Monitor bucket usage.

​

Next steps