kubectl minio init

Description

The kubectl minio init command initialize the MinIO Operator.

If the Kubernetes cluster has an existing MinIO Operator installation, this command upgrades the Operator to match the MinIO plugin version. For more information on upgrading the MinIO Operator, see Upgrade MinIO Operator.

Syntax

The following command initializes a new MinIO Operator deployment running 7.1.1.

kubectl minio init

The command has the following syntax:

kubectl minio init                      \
              [--cluster-domain]        \
              [--console-image]         \
              [--console-tls]           \
              [--default-kes-image]     \
              [--default-minio-image]   \
              [--image]                 \
              [--image-pull-secret]     \
              [--namespace]             \
              [--namespace-to-watch]    \
              [--output]                \
              [--prometheus-name]       \
              [--prometheus-namespace]

Flags

The command supports the following flags:

--cluster-domain

mc-cmd

Optional

The domain name to use when configuring the DNS hostname of the operator. Defaults to cluster.local.

--console-image

mc-cmd

Optional

The image to use when deploying the Operator Console in Operator mode, where administrators can create and manage MinIO tenants using a Graphical User Interface. Defaults to the version bundled in variable DefaultOperatorImage for the matching Operator release.

--console-tls

mc-cmd

Optional

Enables TLS for the Operator Console.

Disabled by default.

--default-kes-image

mc-cmd

Optional

The default kes image to use when creating a new MinIO tenant. Defaults to the version bundled in variable DefaultKESImage for the matching Operator release.

--default-minio-image

mc-cmd

Optional

The default minio image to use when creating a new MinIO tenant. Defaults to the version bundled in variable DefaultTenantImage for the matching Operator release.

--image

mc-cmd

Optional

The image to use for deploying the operator. Defaults to the latest release of the operator.

--image-pull-secret

mc-cmd

Optional

Secret key for use with pulling the --image.

The MinIO-hosted minio/operator image is not password protected. This option is only required for non-MinIO image sources which are password protected.

--namespace

mc-cmd

Optional

The namespace into which to deploy the operator. Defaults to minio-operator.

--namespace-to-watch

mc-cmd

Optional

The namespace which the operator watches for MinIO tenants. Defaults to "" for all namespaces.

--output

mc-cmd

Optional

Performs a dry run and outputs the generated YAML to STDOUT. Use this option to customize the YAML and apply it manually using kubectl apply -f <FILE>.

--prometheus-name

mc-cmd

Optional

The name of the Prometheus service managed by the Prometheus Operator. Defaults to PROMETHEUS_NAME

--prometheus-namespace

mc-cmd

Optional

The namespace into which to deploy Prometheus. Defaults to PROMETHEUS_NAMESPACE

--sts

mc-cmd

Optional

Enable Operator sts (v1alpha1)

Last modified August 2, 2026: init commit (8338d5b)

Portions of this page are adapted from the MinIO Object Storage Documentation, © 2020–Present MinIO, Inc., licensed under CC BY 4.0, converted and maintained by the Silo project. Attribution