< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

Configure a Booster for Installation

If you have trouble downloading images from dockerhub.io, it is highly recommended that you configure a registry mirror (i.e. booster) beforehand to speed up downloads. You can refer to the official documentation of Docker or follow the steps below.

Get a Booster URL

To configure the booster, you need a registry mirror address. See how you can get a booster URL from Alibaba Cloud.

Set the Registry Mirror

You can configure the Docker daemon directly or use KubeKey to set the configuration.

Configure the Docker daemon


Docker needs to be installed in advance for this method.
  1. Run the following commands:

    sudo mkdir -p /etc/docker
    sudo vi /etc/docker/daemon.json
  2. Add the registry-mirrors key and value to the file.

      "registry-mirrors": ["https://<my-docker-mirror-host>"]


    Make sure you replace the address within the quotation mark above with your own Booster URL.
  3. Save the file and reload Docker by executing the following commands so that the change can take effect.

    sudo systemctl daemon-reload
    sudo systemctl restart docker

Use KubeKey to set the registry mirror

  1. After you create a config-sample.yaml file with KubeKey before installation, navigate to registry in the file.

      registryMirrors: []
      insecureRegistries: []
      privateRegistry: ""


    For more information about each parameter under the registry section, see Kubernetes Cluster Configurations.
  2. Provide the registry mirror address as the value of registryMirrors and save the file. For more information about installation, see Multi-node Installation.


If you adopt All-in-One Installation, refer to the first method because a config-sample.yaml file is not needed for this mode.

Receive the latest news, articles and updates from KubeSphere

Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.