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

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>"]
   }
   

   Note

   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.

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

   Note

   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.

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.