Skip to content

MinIO App

About

Minio is a high performance S3 compatible Object Storage.

Admin credentials

To change admin credentials, use the Web terminal to edit the credentials section in /app/data/data/.minio.sys/config/config.json. Note that MinIO does not save this JSON file with identation/formatting, making it hard to edit it. For this reason, we have written a small script that is part of the package to edit it easily.

To set credentials:

# /app/code/minio-credentials set NEWACCESSKEY NEWSECRETKEY
Credentials updated. Restart minio app for new credentials to take effect.

To get the current credentials (in case you forgot it):

# /app/code/minio-credentials get
Access Key: NEWACCESSKEY
Secret Key: NEWSECRETKEY

Access Key Contraints

Please see the AWS Docs for length and pattern restrictions of the access key and secret key. In short, make sure it matches the [\w+=,.@-]+ regexp and has atleast 8 characters

Cloudron Backup

Cloudron supports backing up to minio. Backing up a Cloudron to a minio installed in another Cloudron will work fine. However, backing up a Cloudron to a minio installed in the very same Cloudron is not supported.

Custom configuration

Custom config variables can be exported in /app/data/env.sh. This file is sourced automatically on startup.

Multi-user

MinIO supports multiple long term users in addition to default user created during server startup. New users have to added using the CLI tool. You can read the full docs here.

    mc alias set myminio https://minio.cloudron.club minioadmin minioadmin --api s3v4
  • Create a policy file
cat > getonly.json << EOF
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "s3:GetObject"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:s3:::my-bucketname/*"
      ],
      "Sid": ""
    }
  ]
}
EOF
  • Add the policy
   mc admin policy add myminio getonly getonly.json
  • Add new user
   mc admin user add myminio newuser password123
  • Set policy on user
    mc admin policy set myminio getonly user=newuser