# AWS S3

### Set up Aamazon S3

#### Create IAM User

First we advice to create a dedicated user for API access. Please read more in [Creating an IAM User in Your AWS Account](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console).

During cretion assign "Programmatic access" to this user.

On the last screen copy *Access key ID* and *Secret access key*. These will be used later for plugin configuration. You can also download these credentials.

#### Create a bucket

Proceed to S3 service and click "Create". The wizard will open.

One the first step set you bucket name

<figure><img src="https://norrnext.com/images/docs/norrcompetition/remote-storage/bucket-1.png" alt="One the first step set you bucket name"><figcaption><p>One the first step set you bucket name (for example, <em>ncuploads</em>) and select your region.</p></figcaption></figure>

One the first step set you bucket name (for example, *ncuploads*) and select your region.

<figure><img src="https://norrnext.com/images/docs/norrcompetition/remote-storage/bucket-2.png" alt="One the second step you can configure different options or simply skip it"><figcaption><p>One the second step you can configure different options or simply skip it</p></figcaption></figure>

One the second step you can configure different options or simply skip it

<figure><img src="https://norrnext.com/images/docs/norrcompetition/remote-storage/bucket-3.png" alt="One the third step you must uncheck Block all public access, otherwise API will not have access to your bucket."><figcaption><p>One the third step you must uncheck "Block all public access", otherwise API will not have access to your bucket.</p></figcaption></figure>

One the third step you must uncheck "Block all public access", otherwise API will not have access to your bucket.

<figure><img src="https://norrnext.com/images/docs/norrcompetition/remote-storage/bucket-4.png" alt="One the last step review your settings and click on Create bucket"><figcaption><p>One the last step review your settings and click on "Create bucket".</p></figcaption></figure>

One the last step review your settings and click on "Create bucket".

The bucket will be created and you will see it in the list.

#### Set up public access policy

<figure><img src="https://norrnext.com/images/docs/norrcompetition/remote-storage/bucket-policy.png" alt="To enable public access for your bucket you should set a special policy rule"><figcaption><p>To enable public access for your bucket you should set a special policy rule.</p></figcaption></figure>

To enable public access for your bucket you should set a special policy rule. Proceed to your bucket > *Permissions* > *Bucket Policy* and paste the following rule:

{ "Version": "2012-10-17", "Statement": \[ { "Sid": "AllowPublic", "Effect": "Allow", "Principal": { "AWS": "\*" }, "Action":\[ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:GetObjectAcl", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::ncuploads/\*" } ] }

Of course you should change *ncuploads* to your actual bucket name.

### Plugin Configuration

When S3 bucket is created we are ready to configure the plugin.

<figure><img src="https://norrnext.com/images/docs/norrcompetition/remote-storage/s3-amazon-norrcompetition-settings.png" alt="Flysystem - AWS S3 for NorrCompetition"><figcaption><p>Flysystem - AWS S3 for NorrCompetition</p></figcaption></figure>

1. Install Aamazon S3 storage plugin
2. Proceed to configuration
3. Set the parameters:
   * Access key ID - your access key ID;
   * Secret access key - the key associated with access key;
   * Bucket - the name of the bucket;
   * Prefix (folder) - if you created a folder inside your bucket then set the name of it here;
   * Region - your region
   * Storage Class - select from "Standard" or "Reduced Redundancy"


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.norrnext.com/norrcompetition/remote-storage/aws-s3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
