Skip to main content

Accessing the management cluster

The management cluster is where you create, update, and scale your clusters. Your apps don't run here; by the end of the getting-started guide you'll have a workload cluster where your app runs.

This page walks you through setting up a kubeconfig for the management cluster: you copy the template below and fill in the namespace Syself sends you in your account setup email. If you don't have an account yet, see How do I get access and start? first.

Configure your kubeconfig#

  1. Create a file to store the kubeconfig in

  2. Copy this configuration into the file

    Loading protected content…
  3. Set the namespace in the kubeconfig to the one from your account setup email.

  4. Use chmod 600 <filename> to set the permissions for the file.

  5. Export the kubeconfig to use it via export KUBECONFIG=<path/to/file>.

If you want to make this your default kubeconfig, you can move it to the ~/.kube/config file.

Access Syself Autopilot#

To access the management cluster, you need installed. Run kubectl get clusters. This opens your browser to authenticate. Once you are logged in, kubectl works as usual.

Note

If this is your first time using Syself Autopilot, the output of kubectl get clusters will be No resources found in org-your-company namespace.. This is not an error, it just means no clusters have been created yet under your organization.

Optional: Log out#

You might have to authenticate yourself again, if the token (and refresh token) expires. In case you want to invalidate the current session and remove access to the management cluster, you can use rm -rf ~/.kube/cache/oidc-login.

Next step#

With access to the management cluster in place, prepare the Hetzner account your clusters will run in: .