Configure the bootstrap node

Unsupported since 2.25.0


Regional clusters are unsupported since Container Cloud 2.25.0. Mirantis does not perform functional integration testing of the feature and intends to remove the related code in Container Cloud 2.26.0. If you still require this feature, contact Mirantis support for further information.

This section describes how to prepare a new bootstrap node for an additional regional cluster deployment on top of the management cluster. To use the same node where you bootstrapped the management cluster, skip this instruction and proceed to deploying a regional cluster of the required provider type.

To configure a new bootstrap node for a regional cluster:

  1. Install and configure Docker:

    1. Log in to any personal computer or VM running Ubuntu 20.04 that you will be using as the bootstrap node.

    2. If you use a newly created VM, run:

      sudo apt-get update
    3. Install the current Docker version available for Ubuntu 20.04:

      sudo apt install
    4. Grant your USER access to the Docker daemon:

      sudo usermod -aG docker $USER
    5. Log off and log in again to the bootstrap node to apply the changes.

    6. Verify that Docker is configured correctly and has access to Container Cloud CDN. For example:

      docker run --rm alpine sh -c "apk add --no-cache curl; \

      The system output must contain no error records. In case of issues, follow the steps provided in Troubleshooting.


    If you require all Internet access to go through a proxy server for security and audit purposes, configure Docker proxy settings as described in the official Docker documentation.

  2. Prepare the bootstrap script:

    1. Download and run the Container Cloud bootstrap script:

      sudo apt-get update
      sudo apt-get install wget
      chmod 0755
    2. Change the directory to the kaas-bootstrap folder created by the script.

  3. If you deleted the mirantis.lic file used during the management cluster bootstrap:

    1. Select from the following options:

      • Open the email from with the subject Mirantis Container Cloud License File or Mirantis OpenStack License File

      • In the Mirantis CloudCare Portal, open the Account or Cloud page

    2. Download the License File and save it as mirantis.lic under the kaas-bootstrap directory on the bootstrap node.

    3. Verify that mirantis.lic contains the previously downloaded Container Cloud license by decoding the license JWT token, for example, using

      Example of a valid decoded Container Cloud license data with the mandatory license field:

          "exp": 1652304773,
          "iat": 1636669973,
          "sub": "demo",
          "license": {
              "dev": false,
              "limits": {
                  "clusters": 10,
                  "workers_per_cluster": 10
              "openstack": null


      The MKE license does not apply to mirantis.lic. For details about MKE license, see MKE documentation.

  4. On the new bootstrap node, save the management cluster kubeconfig that was created after the management cluster bootstrap.

Now, proceed to deploying an additional regional cluster of the required provider type as described in Deploy an additional regional cluster.