Hybrid Cloud Object Storage
Baremetal
Erasure Code Calculator
Reference Hardware
Core Settings
This page covers settings that control core behavior of the MinIO process.
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.
Common Settings
Volumes
- MINIO_VOLUMES
The directories or drives the
minio serverprocess uses as the storage backend.Functionally equivalent to setting
minio server DIRECTORIES. Use this value when configuring MinIO to run using an environment file.
This setting does not have a configuration setting option.
Environment Variable File Path
- MINIO_CONFIG_ENV_FILE
Specifies the full path to the file the MinIO server process uses for loading environment variables.
For
systemd-managed files, set this value to the path of the environment file (/etc/default/minio) to direct MinIO to reload changes to that file when usingmc admin service restartto restart the deployment.
This setting does not have a configuration setting option.
Workers for Expiration
Domain
- MINIO_DOMAIN
Set to the Fully Qualified Domain Name (FQDN) MinIO accepts Bucket DNS (Virtual Host)-style requests on.
For example, setting
MINIO_DOMAIN=minio.example.netdirects MinIO to accept an incoming connection request to thedatabucket atdata.minio.example.net.If this setting is omitted, the default is to only accept path-style requests. For example,
minio.example.net/data.
This setting does not have a configuration setting option.
Scanner Speed
Manage the maximum wait period for the scanner when balancing MinIO read/write performance to scanner processes.
MinIO utilizes the scanner for bucket replication, site replication, and lifecycle management tasks.
Valid values include:
|
Removes scanner wait on read/write latency, allowing the scanner to operate at full-speed and IOPS consumption. This setting may result in reduced read and write performance. |
|---|---|
|
Sets a short scanner wait time on read/write latency, allowing the scanner to operate at a higher speed and IOPS consumption. This setting may result in reduced read and write performance. |
|
Sets a moderate scanner wait time on read/write latency, allowing the scanner to operate at a balanced speed and IOPS consumption. This setting seeks to maintain read and write performance while allowing ongoing scanner activity. |
|
Sets a medium scanner wait time on read/write latency, where the scanner operates at a reduced speed and IOPS consumption. This setting allows better read and write performance while reducing scanner performance. May impact scanner-dependent features, such as lifecycle management and replication. |
|
Sets a large scanner wait time on read/write latency, where the scanner operates at a substantially lower speed and IOPS consumption. This setting prioritizes read and write operations at the potential cost of scanner operations. May impact scanner-dependent features, such as lifecycle management and replication. |
Batch Replication
Data Compression
The following section documents settings for enabling data compression for objects. See Data Compression for tutorials on using these configuration settings.
All of the settings in this section fall under the following top-level key:
Allow Encryption
Optional
Set to on to encrypt objects after compressing them.
Defaults to off.
Encrypting compressed objects may compromise security
MinIO strongly recommends against encrypting compressed objects. If you require encryption, carefully evaluate the risk of potentially leaking information about the contents of encrypted objects.
Enable Compression
Optional
Set to on to enable data compression for new objects.
Defaults to off.
Enabling or disabling data compression does not change existing objects.
Compression Extensions
Optional
Comma-separated list of the file extensions to compress.
Setting a new list of file extensions replaces the previously configured list.
Defaults to ".txt, .log, .csv, .json, .tar, .xml, .bin".
Default excluded files
Some types of files cannot be significantly reduced in size.
MinIO will not compress these, even if specified in an extensions argument.
See Excluded types for details.
Compression MIME Types
Optional
Comma-separated list of the MIME types to compress.
Setting a new list of types replaces the previously configured list.
Defaults to "text/*, application/json, application/xml, binary/octet-stream".
Default excluded files
Some types of files cannot be significantly reduced in size.
MinIO will not compress these, even if specified in an mime_types argument.
See Excluded types for details.
Comments
This setting does not have an environment variable option. Use the configuration variable instead.
Optional
Specify a comment to associate with the data compression configuration.