Set Up MinIO Console on TrueNas

An update of MinIO in June 2025 removed the admin console from the UI, leaving you only the command line. Fortunately, a fork called minio-console restores this functionality. This is a tutorial on how to set up minio-console on TrueNAS if you have an existing MinIO instance (updated).

Note: If you are just installing MinIO for the first time, follow this simple tutorial.

Prerequisites

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

Install minio-console

minio-console is a community-supported app on TrueNAS:

When you install it, you need to link it to your MinIO installation http://<truenas-ip>:9000.

Once you install it, you should be able to log in with your minio (default) user credentials.

Troubleshooting

If you log in with the older admin credentials, you may get an error in the logs:

The authorization header is malformed; the region is wrong; expecting 'us-east-1'.

To solve this, first get the region of your MinIO server:

mc admin config get server/ region

I have a weird region name: region name=be-home-rack1.

In this case, you need to edit the TrueNAS minio-console configuration and add an environment variable CONSOLE_MINIO_REGION to match your server's region:

Now update your console configuration (click on the "Update" button at the bottom of the page), wait until the application is updated and log in. You should be able to do it.

HTH,