> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# How to create an AWS IAM user and S3 bucket
> How to create an AWS IAM user and S3 bucket.
export const Image = ({img, alt, size = "lg", background}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
return ;
};
> This guide shows you how you can set up an IAM user and S3 bucket in AWS,
> a prerequisite step for taking backups to S3 or configuring ClickHouse to
> store data on S3
Create an AWS IAM user
In this procedure, we'll be creating a service account user, not a login user.
1. Log into the AWS IAM Management Console.
2. In the `Users` tab, select `Create user`
3. Enter a user-name
4. Select `Next`
5. Select `Next`
6. Select `Create user`
The user is now created.
Click on the newly created user
7. Select `Create access key`
8. Select `Application running outside AWS`
9. Select `Create access key`
10. Download your access key and secret as a .csv for use later
Create an S3 bucket
1. In the S3 bucket section, select **Create bucket**
2. Enter a bucket name, leave other options default
The bucket name must be unique across AWS, not just the organization, or it will emit an error.
3. Leave `Block all Public Access` enabled; public access isn't needed.
4. Select **Create Bucket** at the bottom of the page
5. Select the link, copy the ARN, and save it for use when configuring the access policy for the bucket
6. Once the bucket has been created, find the new S3 bucket in the S3 buckets list and select the bucket name which will take you to the page shown below:
7. Select `Create folder`
8. Enter a folder name that will be the target for the ClickHouse S3 disk or backup and select `Create folder` at the bottom of the page
9. The folder should now be visible on the bucket list
10. Select the checkbox for the new folder and click on `Copy URL`. Save the URL for use in the ClickHouse storage configuration in the next section.
11. Select the **Permissions** tab and click on the **Edit** button in the **Bucket Policy** section
12. Add a bucket policy, example below
```json theme={null}
{
"Version": "2012-10-17",
"Id": "Policy123456",
"Statement": [
{
"Sid": "abc123",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::782985192762:user/docs-s3-user"
},
"Action": "s3:*",
"Resource": [
"arn:aws:s3:::ch-docs-s3-bucket",
"arn:aws:s3:::ch-docs-s3-bucket/*"
]
}
]
}
```
The policy above makes it possible to perform all actions on the bucket
| Parameter | Description | Example Value |
| --------- | ----------------------------------------------------------- | --------------------------------------------------------------------- |
| Version | Version of the policy interpreter, leave as-is | 2012-10-17 |
| Sid | User-defined policy id | abc123 |
| Effect | Whether user requests will be allowed or denied | Allow |
| Principal | The accounts or user that will be allowed | arn:aws:iam::782985192762:user/docs-s3-user |
| Action | What operations are allowed on the bucket | s3:\* |
| Resource | Which resources in the bucket will operations be allowed in | "arn:aws:s3:::ch-docs-s3-bucket", "arn:aws:s3:::ch-docs-s3-bucket/\*" |
You should work with your security team to determine the permissions to be used, consider these as a starting point.
For more information on Policies and settings, refer to AWS documentation:
[https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html)
13. Save the policy configuration