- Creates a slew of folders and pages nested under the mc-server page to store settings. - Breaks up all of the environment variable options formerly in the mc-server page into these separate pages. - Moves the config settings formerly in the mc admin config page to the appropriate new settings pages. - Adds a MiniO Client settings page and document `mc-host-<alias>` Closes #1017
3.1 KiB
Root Access Settings
minio
Table of Contents
This page covers settings that control root (superuser) access for the MinIO process. The root user has complete access and permissions to perform operations on the MinIO deployment.
Root User
Environment Variable
MINIO_ROOT_USER
The access key for the root <minio-users-root>
user.
Warning
If MINIO_ROOT_USER
is unset, minio
defaults to
minioadmin
.
NEVER use the default credentials in production
environments. MinIO strongly recommends specifying a unique, long, and
random MINIO_ROOT_USER
value for all environments.
Configuration Setting
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Root Password
Environment Variable
MINIO_ROOT_PASSWORD
The secret key for the root <minio-users-root>
user.
Warning
If MINIO_ROOT_PASSWORD
is unset, minio
defaults to
minioadmin
.
NEVER use the default credentials in production
environments. MinIO strongly recommends specifying a unique, long, and
random MINIO_ROOT_PASSWORD
value for all environments.
Configuration Setting
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Root Access
Environment Variable
MINIO_API_ROOT_ACCESS
Configuration Setting
api root-access
MinIO Server RELEASE.2023-05-04T21-44-30Z
Specify on
to enable and off
to disable the
root <minio-users-root>
user account. Disabling
the root service account also disables all service accounts associated
with root, excluding those used by site replication. Defaults to
on
.
Ensure you have at least one other admin user, such as one with the
consoleAdmin
policy, before disabling the root account. If you do not have another
admin user, disabling the root account locks administrative access to
the deployment.
You can use this variable to temporarily override the configuration setting and re-enable root access to the deployment.
To reset after an unintentional lock, set MINIO_API_ROOT_ACCESS
on
to override this setting and temporarily re-enable the
root account. You can then change this setting to on
or make the necessary user/policy changes to ensure normal
administrative access through other non-root accounts.