The following prerequisites are required to initiate and complete the cluster creation process.

GPG key

Make sure you have your own GPG key. To list existing keys, run gpg --list-keys

If you don't have any keys, create a new one with gpg --gen-key

Create a new GitHub repository

Go to and create a new private git repository.

This repository will be used by Okctl to store infrastructure-as-code, which means files containing various configurations for your up-and-coming cluster.

Now, run:

# Clone the repository you just made
git clone<the new repository>.git
cd <the new repository>

Prepare information for cluster creation

In order to create a Kubernetes cluster, you will need the following information:

  • Login details: For the default SAML-based login to AWS, you need your Oslo Kommune AD organization username (oooXXXXX) and its password. You also need a Multi-factor token (MFA). If you haven't set up MFA yet, you can do that here.
  • Alternative authentication methods: Okctl also supports authenticating with AWS Single Sign-On (SSO) or IAM access keys. For more details, see the documentation on authenticating to AWS.
  • AWS account ID: This identifies which account you want to use. You can see which accounts you have access to just after logging in to AWS: