8.5 KiB
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
Enables Virtual Host-style requests to the MinIO deployment. Set the value to the Fully Qualified Domain Name (FQDN) for MinIO to accept incoming virtual host requests.
Omitting this setting directs MinIO to only accept the default path-style requests.
For example, consider a MinIO deployment with an assigned FQDN of
minio.example.net.
- With path-style lookups, applications can access the bucket using
its full path as
minio.example.net/mybucket. - With virtual-host lookups, application can access the bucket as a
virtual host as
mybucket.minio.example.net/.
Important
If you configure MINIO_DOMAIN, you must
consider all subdomains of the specified FQDN as exclusively assigned
for use as bucket names. Any MinIO services which conflict with those
domains, such as replication targets, may exhibit unexpected or
undesired behavior as a result of the collision.
For example, if setting MINIO_DOMAIN=minio.example.net,
you cannot assign any subdomains of
minio.example.net (in the form of
*.minio.example.net) to any MinIO service or target. This
includes hostnames for use with bucket <minio-bucket-replication>, batch <minio-batch-framework-replicate-job>, or
site replication <minio-site-replication-overview>.
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.