---
title: "MinIO"
slug: "minio"
description: "Configure MinIO storage for Rocket Chat. Enable secure file uploads, scalability, and reliable collaboration across deployments."
updated: 2026-10-26T10:27:34Z
published: 2026-10-26T10:27:34Z
canonical: "docs.rocket.chat/minio"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# MinIO

## Introduction

MinIO is an object storage server built for cloud applications and DevOps. MinIO is S3 compatible and provides an open-source alternative to AWS S3. You can [download and install](https://minio.io/downloads) MinIO pretty quickly. MinIO also provides an [official Docker image](https://hub.docker.com/hardened-images/catalog/dhi/minio). For further details, check out MinIO [documentation website](https://docs.minio.io/).

## AccessKey and SecretKey

Once you install and deploy MinIO server, you can get the AccessKey and SecretKey from the startup message.

```bash
2017-01-24T19:53:21.141689279Z
2017-01-24T19:53:21.141730078Z Endpoint:  http://172.17.0.2:9000  http://127.0.0.1:9000
2017-01-24T19:53:21.141735582Z AccessKey: 5fD3434325fDaGE77BNJlSoV1xGp
2017-01-24T19:53:21.141738933Z SecretKey: Quie2teech4oofoo9Dahsoo7aithauja
2017-01-24T19:53:21.141742292Z Region:    us-east-1
2017-01-24T19:53:21.141745405Z SQS ARNs:  <none>
2017-01-24T19:53:21.141749472Z
2017-01-24T19:53:21.141752499Z Browser Access:
2017-01-24T19:53:21.141755711Z    http://172.17.0.2:9000  http://127.0.0.1:9000
2017-01-24T19:53:21.141758830Z
2017-01-24T19:53:21.141762000Z Command-line Access: https://docs.minio.io/docs/minio-client-quickstart-guide
2017-01-24T19:53:21.141765638Z    $ mc config host add myminio http://172.17.0.2:9000 1H2MI5BCU45990DZ3WRL flJlSoV1xGp+u2fhfDaGE77BNE6OdyvAsdI15kPq
2017-01-24T19:53:21.141768751Z
2017-01-24T19:53:21.141771631Z Object API (Amazon S3 compatible):
2017-01-24T19:53:21.141774638Z    Go:         https://docs.minio.io/docs/golang-client-quickstart-guide
2017-01-24T19:53:21.142003548Z    Java:       https://docs.minio.io/docs/java-client-quickstart-guide
2017-01-24T19:53:21.142019474Z    Python:     https://docs.minio.io/docs/python-client-quickstart-guide
2017-01-24T19:53:21.142024004Z    JavaScript: https://docs.minio.io/docs/javascript-client-quickstart-guide
2017-01-24T19:53:21.142027614Z
2017-01-24T19:53:21.142030994Z Drive Capacity: 262 GiB Free, 303 GiB Total
```

To override MinIO auto-generated keys, you may explicitly pass secret and access keys as environment variables. Find more details on the MinIO [docs](https://docs.minio.io/docs/minio-docker-quickstart-guide).

## Setup Rocket.Chat to use MinIO

To set up MinIO as the file storage server in Rocket.Chat, go to **Manage → Workspace → Settings → File Upload** and change **Storage Type** from **GridFS** (the default) to **AmazonS3**. Then, in the **Amazon S3** section, update the following details:

| Configuration Name | Description |
| --- | --- |
| Bucket name | MinIO Bucket Name |
| Access Key | MinIO server Access Key |
| Secret Key | MinIO server Secret Access Key |
| Region | us-east-1 |
| Bucket URL | `http://[your.minio.domain/bucketname]` |
| Force Path Style | true (this may not be needed if using SSL) |
| URLs expiration timespan | 0 (if you want your files to never expire) |

## Set up production environment

In production, you can use a reverse proxy with MinIO server. You can also secure access to MinIO server with TLS. Find out more on the MinIO [documentation](https://docs.minio.io/docs/how-to-secure-access-to-minio-server-with-tls).

**Note**: If you specify a different region in MinIO, ensure it is the same as the S3 region. Check the complete [regions list](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-available-regions).