Install MinIO on TrueNas

An update of MinIO in June 2025 removed the admin console from the UI, leaving you only the command line. So, now you have to use the CLI (mc) to set things up like users, buckets ...

This tutorial aims to provide a minimal set of instructions so you can install the minio-console fork that provides full functionality via the UI.

Prerequisites

First, you need to set up MinIO app on your TrueNAS. Just install it from the apps:

You need the MinIO CLI installed on your admin machine (e.g. your PC). I used brew:

brew install minio-mc

Note: If you have midnight commander installed via MC, you need to unlink it:

brew unlink midnight-commander

Configure MinIO CLI

First time you run mc, it'll create a stub configuration in $HOME/.mc. You need to edit the $HOME/.mc/config.json to contain your MinIO install, like this:

"aliases": {
	"server": {
	  "url": "http://<truenas-ip>:9000",
	  "accessKey": "minio",
	  "secretKey": "<minio-user-password>",
	  "api": "S3v4",
	  "path": "auto"
	}
}

Now you can do things like mc ls server/.

Set up console user and policy

As per documentation, first add an user:

mc admin user add server/
Enter Access Key: console
Enter Secret Key:

Then create a policy (for testing):

cat > admin.json << EOF
{
    "Version": "2012-10-17",
    "Statement": [{
        "Action": [
            "admin:*"
        ],
        "Effect": "Allow",
        "Sid": ""
    },
    {
        "Action": [
            "s3:*"
        ],
        "Effect": "Allow",
        "Resource": [
            "arn:aws:s3:::*"
        ],
        "Sid": ""
    }
    ]
}
EOF

... and apply it:

mc admin policy create server/ consoleAdmin admin.json

Now set the policy for the newly created user:

mc admin policy attach server consoleAdmin --user=console

After

After, install the minio-console or move forward via the CLI