GuidesAPI ReferenceJoin the Mailing List

Your Orka environment is a Kubernetes cluster with `tiller` installed and configured. To manage it, you need to install `kubectl` and create a kube account for your Orka environment. Optionally, you can also install `helm` locally to tap into `tiller`.

Your kube account is basically a Kubernetes service account for your Orka environment. It's limited to the `sandbox` namespace and comes with a default RBAC configuration.

  1. Install `kubectl` locally or upgrade your existing installation. For example:

  1. Create a kube account and export the `kubeconfig`. Alternatively, if you already have a kube account, get the respective `kubeconfig` and export it.

  1. Export the resulting `kubeconfig` and verify that `kubectl` is configured properly.

If configured properly, you will see a similar output:

Kubeconfig lost?

Sometimes, after a system or a terminal restart, you might need to re-get and re-export the `kubeconfig` for your account. Run `orka kube get --account NAME -y` followed by `export KUBECONFIG=$(pwd)/kubeconfig-orka`.

  1. (Optional) Install or upgrade `helm`, and verify the installation.

IMPORTANT: Helm version

Use Helm 3. Older versions of Helm rely on [Tiller](🔗) and might not work as expected.

Run `helm version` to check your Helm version.

`HELM_NAMESPACE` must be set to sandbox.

## What's next

Check the [limitations](🔗) imposed by the RBAC configuration and start using `kubectl` and `helm` to manage your cluster.

© 2019-2023 Copyright MacStadium, Inc. – Documentation built with Orka is a registered trademark of MacStadium, Inc.