1
0
mirror of https://github.com/minio/docs.git synced 2025-07-03 16:02:47 +03:00
Files
docs/source/reference/minio-server/settings/root-credentials.rst
Daryl White eb94513104 Breaking up envvars and config settings into separate settings pages (#1028)
- 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
2023-11-03 07:55:22 -04:00

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.