Store files in MinIO

This guide explains how to store the uploaded files of Casdoor, such as avatars, in MinIO, an S3-compatible object store.

---

Learning outcomes

• Prepare MinIO with an access key and a bucket.
• Add MinIO as a storage provider in Casdoor.

What you need

• A MinIO deployment with TLS
• Administrator access to the Casdoor admin console

---

Prepare MinIO

1. Deploy MinIO with TLS and note its API address.

   

2. In the MinIO console, create an access key and a secret key.

   

3. Create a bucket.

   

在 Casdoor 中添加提供商

1. In the Casdoor admin console, go to Identity > Providers and add a provider.

2. Set Category to Storage and Type to MinIO.

3. Fill in the fields:

   字段	MinIO 中的值
   Client ID	Access Key
   Client secret	密钥
   Endpoint	API 地址
   Bucket	存储桶名称

   

4. Save the provider.

Verify the result

Add the provider to your application and upload a file, for example an avatar. The file appears in the MinIO bucket.

See also

• Storage providers
• MinIO integration: Sign users in to MinIO with Casdoor.