Deckhouse Kubernetes Platform in existing cluster

If you want to install Deckhouse into a new cluster, we recommend going back to the previous step and sticking to the section that describes how to deploy a cluster using Deckhouse.

Kubernetes clusters have their own particularities and differences depending on the specific cloud provider, just like clusters deployed manually. The best strategy for installing Deckhouse in such clusters is to install the minimal Deckhouse configuration first, and then enable the necessary modules.

This guide covers installing Deckhouse in a minimal configuration, with the internal documentation module (for a sample web application) and cert-manager module enabled.

After completing all the steps in this guide, you will be able to enable all the modules of interest on your own. Please, refer to the documentation to learn more or reach out to the Deckhouse community.

Installation requirements

  1. Personal computer. The computer from which the installation will be performed.


    • OS: Windows 10+, macOS 10.15+, Linux (e.g. Ubuntu 18.04+, Fedora 35+);
    • installed docker to run the installer (here are the instructions for Ubuntu, macOS, Windows);

    • HTTPS access to the container image registry;
    • the kubectl command-line tool must be configured to communicate with your cluster.
  2. The existing Kubernetes cluster.

    The Kubernetes versions and OS of cluster nodes should be on the list of supported.

    During the installation, the Deckhouse installer running on the personal computer (see step 1) will connect to the cluster and deploy Deckhouse.

    Note that master node-based installation is not currently supported.