Hybrid Cloud Object Storage
Baremetal
Erasure Code Calculator
Reference Hardware
MinIO Console Settings
This page covers settings that manage access and behavior for the MinIO Console.
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.
Browser Settings
The following settings control behavior for the embedded MinIO Console.
MinIO Console
Animation
Browser Redirect
Browser Redirect URL
- MINIO_BROWSER_REDIRECT_URL
Optional
Specify the Fully Qualified Domain Name (FQDN) the MinIO Console listens for incoming connections on.
If you want to host the MinIO Console exclusively from a reverse-proxy service, you must specify the hostname managed by that service.
For example, consider a reverse proxy configured to route
https://example.net/minio/to the MinIO Console. You must set this environment variable to match that hostname for the Console to both listen and respond to requests using that hostname.If you omit this variable, the Console listens and responds to all IP addresses or hostnames associated to the host machine on which the MinIO Server runs.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Session Duration
- MINIO_BROWSER_SESSION_DURATION
Optional
New in version MinIO: Server RELEASE.2023-08-23T10-07-06Z
Specify the duration of a browser session for working with the MinIO Console.
MinIO supports the following units of time measurement:
s- seconds, “60s”m- minutes, “60m”h- hours, “24h”d- days, “7d”
Defaults to
12h.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Server URL
- MINIO_SERVER_URL
Optional
Specify the Fully Qualified Domain Name (FQDN) the MinIO Console must use for connecting to the MinIO Server. The Console also uses this value for setting the root hostname when generating presigned URLs.
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, e.g. due to a reverse proxy or similar configuration.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Log Query URL
- MINIO_LOG_QUERY_URL
Optional
Specify the URL of a PostgreSQL service to which MinIO writes Audit logs. The embedded MinIO Console provides a Log Search tool that allows querying the PostgreSQL service for collected logs.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Prometheus Settings
The following settings manage how MinIO interacts with your Prometheus service.
Prometheus URL
- MINIO_PROMETHEUS_URL
Optional
Specify the URL for a Prometheus service configured to scrape MinIO metrics.
The MinIO Console populates the Dashboard with cluster metrics using the
minio-jobPrometheus scraping job.If you are using a standalone MinIO Console process, this variable corresponds with
CONSOLE_PROMETHEUS_URL.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Prometheus Job ID
- MINIO_PROMETHEUS_JOB_ID
Optional
Specify the custom Prometheus job ID used for scraping MinIO metrics.
MinIO defaults to
minio-job.If you are using a standalone MinIO Console process, this variable corresponds with
CONSOLE_PROMETHEUS_JOB_ID.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
Prometheus Auth Token
- MINIO_PROMETHEUS_AUTH_TOKEN
Optional
Specify the basic auth token the Console should use to connect to a Prometheus service.
For example, a basic auth token you might use could resemble the following:
eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJwcm9tZXRoZXVzIiwic3ViIjoibWluaW8iLCJleHAiOjQ4NTAwMzg0MDJ9.GZCKR3d0FH2TCvNHSd39HaVfSuQVVV0s8glICBDmhT51V6CQ_hw8gTYlKHJmcpR8aHkqiJwCqcYJhaMmqwe00XY
If you are using a standalone MinIO Console process, this variable corresponds with
CONSOLE_PROMETHEUS_AUTH_TOKEN.
This setting does not have a configuration variable setting. Use the Environment Variable instead.
