Site Settings

This page covers settings for site identification and configuration.

Each configuration setting controls fundamental MinIO AIStor behavior and functionality. Test configuration changes in a lower environment, such as DEV or QA, before applying to production.

Site name

Optional

MINIO_SITE_NAME

Specify a name for the MinIO AIStor deployment. This name identifies the cluster in SUBNET registration and other administrative contexts.

If not set, MinIO AIStor automatically generates a name at startup using the format <MythicalCreature><Element> (for example, “GriffinWave”, “UnicornFrost”, “KrakenStone”). The auto-generated name persists across restarts.

When set as an environment variable, the name takes precedence and cannot be changed using mc admin name set or mc admin config set.

export MINIO_SITE_NAME="production-cluster"
site name

Specify a name for the MinIO AIStor deployment.

mc admin config set ALIAS site name="production-cluster"

You can also use mc admin name set to set or change the name:

mc admin name set ALIAS production-cluster

To view the current name:

mc admin name get ALIAS

Site region

Optional

Specify a region for the MinIO AIStor deployment. This setting is used for site replication configurations.

MINIO_SITE_REGION
export MINIO_SITE_REGION="us-east-1"
site region
mc admin config set ALIAS site region="us-east-1"

Site comment

Optional

Specify an optional free-text comment describing the MinIO AIStor deployment.

MINIO_SITE_COMMENT
export MINIO_SITE_COMMENT="Primary cluster in the SFO datacenter"
site comment
mc admin config set ALIAS site comment="Primary cluster in the SFO datacenter"

On this page