Skip to content

Deploying Kelda

This guide will quickly get you up and running with your own instance of Kelda. We will deploy Kelda to a Kubernetes cluster, install the CLI, and deploy the same application used in the Quickstart.

Dependencies

This guide assumes that you have:

  • Installed kubectl.
  • Downloaded your Kelda license. This should have been emailed to you by the Kelda team.

Setup

  1. Create the Kubernetes cluster that Kelda will run on

    We recommend a cluster with at least 4CPUs and 8GB of RAM.

    Create the cluster using one of the options here.

  2. Point your local kubeconfig at the cluster

    If you successfully created your Kubernetes cluster, it should show up under kubectl config get-contexts.

    Switch to the proper context with kubectl config use-context <context name>.

    As a sanity check, make sure that kubectl get nodes doesn't error.

  3. Install the latest Kelda release

    Paste the following into your shell to download the latest Kelda release:

    curl -fsSL 'https://kelda.io/install.sh' | sh
    

    You should see the following output:

    Downloading the latest Kelda release...
    ################################################################# 100.0%
    The latest Kelda release has been downloaded to the current working directory.
    Please install Kelda to your desired location, or use the snippet below to install it to /usr/local/bin.
    
        sudo cp ./kelda /usr/local/bin
    

    Use the provided snippet to install Kelda into /usr/local/bin.

  4. Deploy the Kelda Minion

    The Kelda CLI communicates with the Kelda minion, which in turn communicates with the Kubernetes API to keep the development namespaces up and running.

    Run the following command to deploy the Minion to the cluster you created in step 1.

    kelda setup-minion --license <path to license>
    
  5. Confirm that everything installed successfully

    If everything installed successfully, running

    kelda version
    

    Should show something like

    local version:  0.14.2
    minion version: 0.14.2
    

Congratulations! You've now setup your own instance of Kelda that can be used to run your applications. Check out the configuration documentation to learn how to start developing on your own application.