# AWS S3 File Storage

With IceHrm you can use Amazon S3 as your file system. In order to do that you need to first create an S3 bucket for icehrm. For this example, let's assume the name you are selecting for your s3 bucket is **icehrmpro-test.**

### **Configuration**

1. Goto AWS S3 console and create the bucket

![Create S3 Bucket](/files/-MbVvT3YvDUxUhFLm_OO)

2\. Make sure the bucket access is public. This doesn't mean the file stored here by IceHrm is public. A secure has is needed every time a file is accessed.

![](/files/-MbVw8zg4wy-oN5YEzlc)

3\. Create an IAM user with access to S3. (You may use restrict permission for this user only to a selected bucket if needed)

![](/files/-MbVwb_cXKqwhRJnog61)

![](/files/-MbVwfnc1mIeoUoMBInr)

4\. Update IceHrm Settings Accordingly Under System->Settings

![](/files/-MbVxGel8B9ysAVlTkmt)

5\. Set "**System: AWS Region**" setting under **System->Settings correctly**.

### Testing

* Update a file for an employee via the documents module
* Check if you can download the file and make sure it's being downloaded via S3 URL
* If successful upload all the files in icehrm/app/data to s3 bucket and make sure file permissions are not set to public
* Try downloading an old file

{% hint style="warning" %}
Test and make sure your S3 files can not be accessed publicly.
{% endhint %}


---

# 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://icehrm.gitbook.io/icehrm/getting-started/using-aws-s3-for-icehrm-file-storage.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.