Deprecated Settings
This page covers deprecated settings that control core behavior of the MinIO process.
Settings on this page may be removed at any time. Users should migrate to the recommended replacement at the earliest opportunity.
You can establish or modify settings by defining:
an environment variable on the host system prior to starting or restarting the MinIO Server. Refer to your operating system’s documentation for how to define an environment variable.
a configuration setting using
mc admin config set
.a configuration setting using the MinIO Console’s Administrator > Settings pages.
If you define both an environment variable and the similar configuration setting, MinIO uses the environment variable value.
Some settings have only an environment variable or a configuration setting, but not both.
Important
Each configuration setting controls fundamental MinIO behavior and functionality. MinIO strongly recommends testing configuration changes in a lower environment, such as DEV or QA, before applying to production.
Environment Variables
The following environment variables are deprecated. They are listed here for historical reference only.
- MINIO_SECRET_KEY
Deprecated since version RELEASE.2021-04-22T15-44-28Z.
The secret key for the root user.
This environment variable is deprecated in favor of the
MINIO_ROOT_PASSWORD
environment variable.Warning
If
MINIO_SECRET_KEY
is unset,minio
defaults tominioadmin
.NEVER use the default credentials in production environments. MinIO strongly recommends specifying a unique, long, and random
MINIO_ACCESS_KEY
value for all environments.
- MINIO_ACCESS_KEY
Deprecated since version RELEASE.2021-04-22T15-44-28Z.
The access key for the root user.
This environment variable is deprecated in favor of the
MINIO_ROOT_USER
environment variable.Warning
If
MINIO_ACCESS_KEY
is unset,minio
defaults tominioadmin
.NEVER use the default credentials in production environments. MinIO strongly recommends specifying a unique, long, and random
MINIO_ACCESS_KEY
value for all environments.
- MINIO_ACCESS_KEY_OLD
Deprecated since version RELEASE.2021-04-22T15-44-28Z.
To perform root credential rotation, modify the
MINIO_ROOT_USER
andMINIO_ROOT_PASSWORD
environment variables.
- MINIO_SECRET_KEY_OLD
Deprecated since version RELEASE.2021-04-22T15-44-28Z.
To perform root credential rotation, modify the
MINIO_ROOT_USER
andMINIO_ROOT_PASSWORD
environment variables.
- MINIO_SERVER_URL
Deprecated since version RELEASE.2024-05-10T01-41-38Z.
The fully qualified domain name (FQDN) the MinIO Console uses for connecting to the MinIO Server.
For the Console to function correctly, the MinIO server URL must be the FQDN of the host, resolveable, and reachable.
If the specified value does not resolve to the MinIO server, logins via the MinIO Console fail and return a network error after a wait period. Older versions of the Console may return a generic ‘Invalid Login’ error instead. Unset the value or address the FQDN resolution issue to allow Console logins to proceed. This setting may be required if:
The MinIO Server uses a TLS certificate that does not include the host local IP(s) in the certificate Subject Alternative Name (SAN).
or
The Console must use a specific hostname to connect or reference the MinIO Server, such as due to a reverse proxy or similar configuration.