Edit

opencenter cluster init

Initialize a new cluster configuration (non-interactive)

Synopsis

Initialize a new cluster configuration with default values.

This command creates a new cluster configuration file with sensible defaults based on the JSON schema. You can override any configuration value using command-line flags with dot notation.

This command generates schema version "2.0" configuration only.

The configuration is created in an organization-based directory structure: ~/.config/opencenter/clusters/<organization>/<cluster>/</cluster></organization>

By default, the organization is set to "opencenter". Use --org to specify a different organization.

SOPS Age encryption keys and SSH key pairs are automatically generated if they don’t already exist, unless --no-keygen is specified.

opencenter cluster init [name] [flags]

Examples

  # Initialize with defaults
  opencenter cluster init my-cluster

  # Initialize from existing config file
  opencenter cluster init --config-file my-cluster-config.yaml

  # Initialize with organization
  opencenter cluster init my-cluster --org myorg

  # Initialize a VMware cluster
  opencenter cluster init my-cluster --org production --type vmware

  # Initialize a Kind cluster with the built-in CNI disabled
  opencenter cluster init my-cluster --org local --type kind --kind-disable-default-cni

  # Initialize without key generation
  opencenter cluster init my-cluster --no-keygen

  # Overwrite existing config
  opencenter cluster init my-cluster --force

Options

      --config-file string         load configuration from file
      --force                      overwrite existing config file
      --full-schema                generate configuration with all available fields
  -h, --help                       help for init
      --kind-disable-default-cni   disable Kind's default CNI so cluster networking is managed by openCenter
      --no-keygen                  do not auto-generate keys
      --no-sops-keygen             do not auto-generate SOPS keys
      --org string                 organization name (defaults to 'opencenter')
      --regenerate-keys            regenerate keys even if they exist
      --server-pool stringArray    additional server pool configuration
      --strict                     fail if required values are missing
      --type string                cluster type: openstack, baremetal, kind, vmware (default "openstack")

SEE ALSO

  • opencenter_cluster.md[opencenter cluster] - Manage cluster configurations

Auto generated by spf13/cobra on 28-Apr-2026