---
title: "Upload an Object"
slug: "upload-an-object-s3cmd"
updated: 2026-10-27T17:23:57Z
published: 2026-10-27T17:23:57Z
canonical: "docs.vastdata.com/upload-an-object-s3cmd"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload an Object

```plaintext
s3cmd [-c CONFIGFILE] [--disable-multipart] put FILE [FILE...] s3://BUCKET[/PREFIX]
```

| CONFIGFILE | Configuration file. Defaults to $HOME/.s3cfg |
| --- | --- |
| --disable-multipart | Disables multipart upload for files over 15 MB (which by default are loaded as multipart uploads) |
| FILE | Name of local file to upload |
| BUCKET | Name of bucket to which to upload file |
| PREFIX | Prefix to append to the object name from which file system hierarchy can be inferred. When listing objects in the bucket, the prefix can be used to filter the list. You can specify a nested series of prefixes delimited by the delimiter (which is typically '/'). Object listing can be filtered by prefixes and delimiters. See [List Objects in a Bucket](/docs-5-3/docs/en/list-objects-in-a-bucket-s3cmd). For example, when uploading a file called *file.asp*, if you specify a prefix */dev/misc* the complete S3 object key becomes *dev/misc/file.asp*. A file system hierarchy can be inferred consisting of a folder called *misc* nested under a folder called *dev* in which the file *file.asp* is contained. |

## Example

Add file *blue.txt* to bucket *bucket1*.

```plaintext
$ s3cmd -c vast.s3cfg put blue.txt s3://bucket1
upload: 'blue.txt' -> 's3://bucket1/blue.txt'  [1 of 1]
205 of 205   100% in  0s  4.33 kB/s  done
```