Replication Settings

This page covers settings that control bucket and site replication behavior for the MinIO AIStor process.

You can establish or modify settings by defining:

• an environment variable on the host system prior to starting or restarting the AIStor Server. Refer to your operating system’s documentation for how to define an environment variable.
• a configuration setting using mc admin config set.

If you define both an environment variable and the similar configuration setting, MinIO AIStor uses the environment variable value.

Some settings have only an environment variable or a configuration setting, but not both.

Set the replication priority, which controls how aggressively replication consumes system resources.

Valid values:

• auto - MinIO AIStor automatically adjusts replication speed based on available resources.
• fast - Prioritize replication throughput over other background operations.
• slow - Reduce replication resource usage to minimize impact on client workloads.

The default value is auto.

Set the maximum number of replication workers per node. Each worker handles one replication operation at a time.

Valid values are 1 to 500.

The default value is 500.

Set the maximum number of replication workers dedicated to large object transfers (128 MiB and larger). Separating large transfers prevents them from blocking the replication queue for smaller objects.

Valid values are 1 to 10.

The default value is 10.

Set the S3 Replication Time Control (RTC) threshold duration. MinIO AIStor emits s3:ReplicationMissedThreshold or s3:ReplicatedAfterThreshold notification events based on this value.

Specify a Go-compatible duration string such as 15m or 30m. The minimum value is 1m (one minute).

The default value is 15m.