---
name: satellite-setup-clusters-satconfig-groups
title: Setting up cluster groups
description: The cluster group specifies all clusters that you want to include in the deployment of your Kubernetes resources. The clusters can run in your Satellite location or in IBM Cloud.
last-updated: 2026-08-14
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/satellite?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Setting up cluster groups
{: #setup-clusters-satconfig-groups}

The cluster group specifies all clusters that you want to include in the deployment of your Kubernetes resources. The clusters can run in your Satellite location or in IBM Cloud.
{: shortdesc}

If you want to use the console to create Satellite configurations, you can create cluster groups as part of the configuration creation process. If you want to use the CLI to create Satellite configurations, you must create a cluster group first. Follow these steps to create a cluster group with the CLI:

1. List the clusters that are registered with the Satellite Config component and note their ID.
    ```sh
    ibmcloud sat cluster ls
    ```
    {: pre}

2. Add the cluster to your cluster group.    
    ```sh
    ibmcloud sat group attach --cluster CLUSTER_ID --group CLUSTER_GROUP_NAME
    ```
    {: pre}

3. Verify that your cluster is successfully added to your cluster group.
    ```sh
    ibmcloud sat group get --group CLUSTER_GROUP_NAME
    ```
    {: pre}