• English (Great Britain)

      • MinIO Administration Guide for New Versions

      In newer versions, MinIO has removed administrative functionality from the Web UI. You now need to use the MinIO Client (mc) command-line tool for all management operations.

      Installing MinIO Client (mc)

      Windows:

      # Download mc.exe
Invoke-WebRequest -Uri "https://dl.min.io/client/mc/release/windows-amd64/mc.exe" -OutFile "mc.exe"

# Or using Chocolatey
choco install minio-client

      Linux/macOS:

      # Linux
wget https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc
sudo mv mc /usr/local/bin/

# macOS
brew install minio/stable/mc

      Configuring the MinIO Client

      # Add a MinIO server alias
mc alias set myminio http://localhost:9000 minioadmin minioadmin

# Verify the connection
mc admin info myminio

      User Management

      Creating Users

      # Create a new user
mc admin user add myminio newuser newpassword

# List all users
mc admin user list myminio

      Creating Access Keys and Secret Keys

      # Create a service account for a user (generates AccessKey/SecretKey)
mc admin user svcacct add myminio newuser

# Or specify custom AccessKey and SecretKey
mc admin user svcacct add myminio newuser --access-key "MYACCESSKEY123" --secret-key "MYSECRETKEY456"

# View a user's service accounts
mc admin user svcacct list myminio newuser

      Permission Management

      Creating Policies

      # Create a policy file policy.json
cat > policy.json << EOF
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject"
      ],
      "Resource": [
        "arn:aws:s3:::mybucket/*"
      ]
    }
  ]
}
EOF

# Add the policy
mc admin policy add myminio mypolicy policy.json

# Assign the policy to a user
mc admin policy set myminio mypolicy user=newuser

      Bucket Management

      # Create a bucket
mc mb myminio/mybucket

# List buckets
mc ls myminio

# Set bucket policy
mc policy set public myminio/mybucket

      Common Administration Commands

      # View server information
mc admin info myminio

# View server configuration
mc admin config get myminio

# Restart the server
mc admin service restart myminio

# View logs
mc admin logs myminio

# View statistics
mc admin prometheus metrics myminio

      Practical Script Example

      Create an administration script setup-minio.sh:

      #!/bin/bash

MINIO_ALIAS="myminio"
MINIO_URL="http://localhost:9000"
ADMIN_USER="minioadmin"
ADMIN_PASS="minioadmin"

# Configure the MinIO client
mc alias set $MINIO_ALIAS $MINIO_URL $ADMIN_USER $ADMIN_PASS

# Create an application user
APP_USER="appuser"
APP_PASS="apppassword"
mc admin user add $MINIO_ALIAS $APP_USER $APP_PASS

# Create a service account and retrieve AccessKey/SecretKey
echo "Creating service account for $APP_USER..."
CREDENTIALS=$(mc admin user svcacct add $MINIO_ALIAS $APP_USER --json)
ACCESS_KEY=$(echo $CREDENTIALS | jq -r '.accessKey')
SECRET_KEY=$(echo $CREDENTIALS | jq -r '.secretKey')

echo "Generated credentials:"
echo "Access Key: $ACCESS_KEY"
echo "Secret Key: $SECRET_KEY"

# Create a bucket
mc mb $MINIO_ALIAS/app-bucket

# Set a read-only policy
mc policy set download $MINIO_ALIAS/app-bucket

      Web Console Access

      Although administrative functionality has been removed, you can still access the MinIO Console via:

      # Launch the MinIO Console (if installed separately)
mc admin console myminio

      Alternatively, specify the console address when starting the MinIO server:

      minio server /data --console-address ":9001"

      Summary

      Managing the new MinIO relies entirely on the mc command-line tool:

      1. Install the mc client
      2. Configure the server alias
      3. Use mc admin commands for user, permission, and bucket management
      4. Generate AccessKeys/SecretKeys via mc admin user svcacct

      While this approach requires command-line operations, it provides more powerful and flexible management capabilities, particularly suited for automated deployment and script-based management.

      miniostorages3devopscheatsheet