docs/source/reference/minio-server/settings/core.rst

Core Settings

minio

Table of Contents

This page covers settings that control core behavior of the MinIO process.

Common Settings

Volumes

Environment Variable

MINIO_VOLUMES

The directories or drives the minio server process uses as the storage backend.

Functionally equivalent to setting minio server DIRECTORIES. Use this value when configuring MinIO to run using an environment file.

Configuration Setting

Environment Variable File Path

Environment Variable

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 using mc admin service restart to restart the deployment.

Configuration Setting

Workers for Expiration

Environment Variable

MINIO_ILM_EXPIRY_WORKERS

Specifies the number of workers to make available to expire objects configured with ILM rules for expiration. When not set, MinIO defaults to using up to half of the available processing cores available.

Configuration Setting

Domain

Environment Variable

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.net directs MinIO to accept an incoming connection request to the data bucket at data.minio.example.net.

If this setting is omitted, the default is to only accept path-style requests. For example, minio.example.net/data.

Configuration Setting

Scanner Speed

Environment Variable

MINIO_SCANNER_SPEED

Configuration Setting

scanner speed

Manage the maximum wait period for the scanner when balancing MinIO read/write performance to scanner processes.

Batch Replication

Environment Variable

MINIO_BATCH_REPLICATION_WORKERS

Optional

Specifying the maximum number of parallel processes to use when performing the batch application job.

Configuration Setting

Data Compression

The following section documents settings for enabling data compression for objects. See minio-data-compression for tutorials on using these configuration settings.

All of the settings in this section fall under the following top-level key:

compression

Allow Encryption

Environment Variable

MINIO_COMPRESSION_ALLOW_ENCRYPTION

Configuration Setting

compression 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

Environment Variable

MINIO_COMPRESSION_ENABLE

Configuration Setting

compression enable

Optional

Set to on to enable data compression for new objects. Defaults to off.

Enabling or disabling data compression does not change existing objects.

Comments

Environment Variable

This setting does not have an environment variable option. Use the configuration variable instead.

Configuration Setting

compression comment

Optional

Specify a comment to associate with the data compression configuration.

Compression Extensions

Environment Variable

MINIO_COMPRESSION_EXTENSIONS

Configuration Setting

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 ~compression.extensions argument. See Excluded types <minio-data-compression-excluded-types> for details.

Compression MIME Types

Environment Variable

MINIO_COMPRESSION_MIME_TYPES

Configuration Variable

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 ~compression.mime_types argument. See Excluded types <minio-data-compression-excluded-types> for details.