To copy the files from a local folder to an S3 bucket, run the `s3 sync` command, passing in the source directory and the destination bucket as inputs.

Copy a Local Folder to an S3 Bucket


## Copy a Local Folder to an S3 Bucket

**To copy the files from a local folder to an S3 bucket, run the `s3 sync`
command, passing in the source directory and the destination bucket as inputs.**

Let's look at an example, which copies the files from the current directory to
an S3 bucket. Open your terminal in the directory which contains the files you
want to copy and run the
[s3 sync](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/sync.html)
command.

```bash:shell
aws s3 sync . s3://YOUR_BUCKET
```

![copy local folder to bucket](/images/blog/aws-s3-copy-local-folder-to-bucket/copy-local-folder-to-bucket.webp)

<InArticleAd />

The output shows that the files and folders contained in the local directory
were successfully copied to the s3 bucket.

You can also pass the directory as an absolute path, for example:

```bash:shell
# on Linux or macOS
aws s3 sync /home/john/Desktop/my-folder s3://YOUR_BUCKET

# on Windows
aws s3 sync C:\Users\USERNAME\my-folder s3://YOUR_BUCKET
```

<Alert>
  To make sure the command does what you expect, you can run the command in test
  mode by adding the <code>--dryrun</code> parameter. This enables us to show
  the command's outputs, without actually running it.
</Alert>

```bash:shell
aws s3 sync . s3://YOUR_BUCKET --dryrun
```

![run s3 cp in test mode](/images/blog/aws-s3-copy-local-folder-to-bucket/run-s3-cp-in-test-mode.webp)

<InArticleAd />

You might be wondering what would happen if the bucket contains a file with the
same name and path as a file in the local folder.

The `s3 sync` command copies the objects from the local folder to the
destination bucket, if:

- the size of the objects differs
- the last modified time of the source is newer than the last modified time of
  the destination
- the s3 object does not exist under the specified prefix in the destination
  bucket

This means that if we had a `document.pdf` file in both the local directory and
the destination bucket, it would only get copied if:

- the size of the document differs
- the last modified time of the document in the local directory is newer than
  the last modified time of the document in the destination bucket

**To copy a local folder to a specific folder in an S3 bucket, run the `s3 sync`
command, passing in the source directory and the full bucket path, including the
directory name.**

The following command copies the contents of the current folder to a `my-folder`
directory in the S3 bucket.

```bash:shell
aws s3 sync . s3://YOUR_BUCKET/my-folder/
```

![copy local folder to folder in bucket](/images/blog/aws-s3-copy-local-folder-to-bucket/copy-local-folder-to-folder-in-bucket.webp)

The output shows that `example.txt` was copied to
`bucket/my-folder/example.txt`.

<InArticleAd />

## Further Reading

- [AWS CDK Tutorial for Beginners - Step-by-Step Guide](/blog/aws-cdk-tutorial-typescript)
- [How does AWS CDK work](/blog/how-does-aws-cdk-work)
- [What is a Token in AWS CDK](/blog/what-is-aws-cdk-token)
- [CDK Constructs - Complete Guide](/blog/cdk-constructs-tutorial)
- [What is an identifier (id) in AWS CDK](/blog/aws-cdk-identifiers)
- [How to use Context in AWS CDK](/blog/how-to-use-context-aws-cdk)
- [How to use Parameters in AWS CDK](/blog/aws-cdk-parameters-example)

<InArticleAd />


Copy a Local Folder to an S3 Bucket

Copy a Local Folder to an S3 Bucket #

Further Reading #

Borislav Hadzhiev

For more articles, navigate to myHome Page

Copy a Local Folder to an S3 Bucket