> For the complete documentation index, see [llms.txt](https://docs.zata.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zata.ai/knowledgebase/mount-s3-bucket-to-linux-operating-system.md).

# Mount S3 bucket to Linux operating system

To mount an S3 bucket to a Linux machine, you can use a tool like **s3fs**

Step 1: Install dependencies

```
sudo apt-get update -y
sudo apt-get install s3fs -y
```

Step 2: Store your credentials

Create a credentials file to store your access and secret keys securely

```
echo ACCESS_KEY_ID:SECRET_ACCESS_KEY > ~/.passwd-s3fs
chmod 600 ~/.passwd-s3fs
```

Replace `ACCESS_KEY_ID` and `SECRET_ACCESS_KEY` with your actual credentials.

<figure><img src="/files/QyhlJB9MwOSFbEErHG4N" alt=""><figcaption></figcaption></figure>

Step 3: Create a mount point

Create a directory where the S3 bucket will be mounted:

```
sudo mkdir /mnt/s3bucket
```

<figure><img src="/files/Znod7EbHl7pNQMFgU4Gs" alt=""><figcaption></figcaption></figure>

Step 4: Mount S3-Compatible Storage with Path-Style Addressing

```
s3fs BUCKET_NAME /mnt/s3bucket -o passwd_file=~/.passwd-s3fs,url=https://YOUR_S3_ENDPOINT,allow_other,use_cache=/tmp,sigv4,use_path_request_style

```

#### Breakdown of the Options:

* `BUCKET_NAME`: Replace this with your actual bucket name.
* `/mnt/s3bucket`: The mount point where the bucket will be mounted.
* `-o passwd_file=~/.passwd-s3fs`: Specifies the path to the file where your credentials are stored (replace with your own credentials file path if necessary).
* url=[https://idr01.zata.ai ](https://idr01.zata.ai)(or <https://bom01.zata.ai> for Southern India) with your S3-compatible service's endpoint.
* `allow_other`: Allows other users to access the mounted directory.
* `use_cache=/tmp`: Caches files locally `/tmp` to improve performance.
* `sigv4`: Forces Signature Version 4 signing (needed for most S3-compatible services).
* `use_path_request_style`: Forces path-style addressing, which is required for some S3-compatible service

Step 5: Verify the mount

```
sudo df -h
```

<figure><img src="/files/mQXOwV5OsXjfRT2cynBm" alt=""><figcaption></figcaption></figure>

Now check to mount to navigate to the directory and create a new file on your system.

<figure><img src="/files/BSea0kgMBDWw8ckjVohz" alt=""><figcaption></figcaption></figure>

Now back to the Zata.ai dashboard click on the bucket section, select the bucket, and check the content

<figure><img src="/files/VtZZ6ZgNq22QXKiby3t9" alt=""><figcaption></figcaption></figure>

**Lets see file has been created.**

<figure><img src="/files/4tMuMnR0MiePDOtuGJEn" alt=""><figcaption></figcaption></figure>

**To mount an S3-compatible bucket with path-style addressing** **permanently** (so that it is automatically mounted at boot), you can add an entry to your **/etc/fstab** file. Here’s how to configure that:

Open **/etc/fstab** in an editor

```
sudo vi /etc/fstab
```

Add an entry to mount your S3 bucket. The format should look like this:

```
s3fs#Bucket_Name /mnt/s3bucket fuse _netdev,nonempty,allow_other,url=https://idr01.zata.ai,use_path_request_style,passwd_file=/root/.passwd-s3fs 0 0
# For Mumbai, use url=https://bom01.zata.ai
```

Replace **`BUCKET_NAME`** with your S3 bucket name.

<figure><img src="/files/F85ixieSwjhbEeGMTMq6" alt=""><figcaption></figcaption></figure>

Now, check if the mount entry in /etc/fstab works properly by running the following command

```
sudo mount -a
```

Now, reload the daemon service

```
sudo systemctl daemon-reload
```

Now, reboot the system and check the mount directory.

```
df -h
```

<figure><img src="/files/SKAHoce1KFowQrQRgSrp" alt=""><figcaption></figcaption></figure>

Verify the Mount:- To confirm that the bucket is mounted, list the contents of your mount point.

<pre><code><strong>sudo ls /mnt/s3bucket
</strong></code></pre>

<figure><img src="/files/L4Nh0EsfhF6fjJuxemst" alt=""><figcaption></figcaption></figure>
