Skip to content

MinIO (S3 Compatible)

Store files using MinIO with S3 compatible storage policy.

Configuration

Refer to the MinIO official documentation to deploy your MinIO cluster.

  1. Use the Web panel or command line tool mc mb to create a bucket;
  2. Use the Web panel or command line tool mc admin accesskey create to create a set of access keys.

In Cloudreve, create an S3 Compatible storage policy and fill in the information according to the following rules:

  • For Bucket Name in the storage policy, enter the name of the bucket you just created;
  • For Endpoint in the storage policy, enter the API endpoint of your MinIO cluster, and check Force Path Style Endpoint;
  • For Region in the storage policy, enter us-east-1;
  • For Access credential in the storage policy, enter the Access Key and Secret Key of the access key you just created;

MinIO does not need to configure a CORS policy, click I have set it manually to skip CORS policy creation.

FAQ

Upload error: Chunk upload failed: X-Amz-Expires must be less than a week (in seconds)

Check Settings -> Filesystem -> Upload session TTL (seconds), its value should be less than 604800.

Upload error: Request failed: AxiosError: Network Error
  1. Check if the user can connect to your MinIO cluster API endpoint;
  2. If your Cloudreve site has HTTPS enabled, please configure HTTPS for the MinIO endpoint, or proxy the MinIO endpoint through a web server;
Transfer upload failed, error: Unable to parse response
  1. Expand the detailed error and check if the error message contains 413 Request Entity Too Large.

    If so, modify your Nginx reverse proxy configuration, set or increase the value of client_max_body_size, such as client_max_body_size 20000m;. This setting value should be larger than the size of the files being uploaded.

  2. Check if there is an external WAF firewall blocking the upload request.