Skip to main content
Version: 0.9

Bootstrap a Cluster for Kore

Kore itself runs inside a Kubernetes cluster, and this section discusses how you can use a local instance of Kore on your workstation to bootstrap a cloud cluster to install Kore for your organization.

Prerequisites for running these steps#

To run Kore locally, you will need Docker installed. Both Mac OSX and Linux have been tested; this process may not work correctly on a Windows workstation.

Get the Kore CLI#

For instructions, see Get the CLI.

Create a local Kore install#

To get Kore running locally, simply run:

kore local up

This will take several minutes to create a cluster using Kind and install the current Kore Helm chart into it.

Log in#

As you have not configured an IDP, you should log in using the credentials output by the above command.

kore login local -a http://localhost:10080

You can also log in to the UI using the same credentials at http://localhost:3000.

Add cloud account#

Kore needs a cloud account to use in order to create a cluster to run Kore in - find out about the various types of cloud accounts supported by Kore in the cloud accounts section.

Add a cloud account to your local Kore for the cloud you wish to host your Kore cluster in. You can do this via the UI (Configure > Cloud > Organization or Configure > Cloud > Account/Project/Subscription) or using the CLI:

kore create cloudcredential crednamekore create cloudaccount accountname

These will prompt you for all required values. For more detail, see the full CLI documentation for adding a cloud credential and cloud account.

Create the cluster#

Now you have credentials in your local Kore instance, you can proceed to create the cluster in your chosen cloud provider:

  1. Create a team (e.g. myorg-infra) in Kore via CLI or via the UI.
  2. Create the cluster - we recommend doing this via the UI for this initial cluster so you have full visibility of the options used, however it is also possible via the CLI.

Add cluster to your local kubectl context#

Finally, once you have created the cluster successfully, from the CLI, you can add it to your local kubectl contexts, ready to install Kore:

kore kubeconfig -t myorg-infra

Ensure you choose to set your current context to the cluster you have built.

You now have a Kubernetes cluster to install Kore into - ensure you follow the remaining steps from the prerequisites before continuing to install Kore into this new cluster.

Last updated on Aug 5, 2021