Deckhouse 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 process

You will need:

  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 (it is also possible to use a third-party registry);
    • the kubectl command-line tool must be configured to communicate with your cluster.
  2. The existing Kubernetes cluster.

    You will need a running Kubernetes cluster with the supported Kubernetes version and OS.

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

    By default, the default storage class defined in the cluster is used as storage for system components (or emptydir, if it is not defined). You can specify the storage class using the global parameter storageClass.