Quickstart

Create your account

Sign up to create your account.

Connect a Kubernetes cluster

Create an access key

Download the Infra CLI:

Download via homebrew:

brew install infrahq/tap/infra

Next, log in:

infra login <org>.infrahq.com

You will be prompted for the Infra server domain you created when you signed up (e.g. <org>.infrahq.com).

Then, create an access key:

INFRA_ACCESS_KEY=$(infra keys add --connector -q)

Connect cluster

Install Infra connector via helm:

helm repo add infrahq https://helm.infrahq.com
helm repo update
helm install infra infrahq/infra --set connector.config.server=$INFRA_SERVER --set connector.config.accessKey=$INFRA_ACCESS_KEY --set connector.config.name=example

It may take a few minutes for your cluster to connect.

To finish, verify that your cluster is connected:

infra destinations list

Access your cluster

Grant yourself access to the cluster:

infra grants add <your user email> example --role view

Next, verify your access:

infra list

Then, run kubectl to switch to your newly connected cluster.

kubectl config use-context infra:example

Alternatively, you can switch clusters via infra use command.

infra use example

Lastly, try running a command on the Kubernetes cluster:

kubectl get pods -A

By default, Infra will give view access to the user who made the install. To modify permissions or give additional access, use Infra dashboard or CLI.

Next steps

Congratulations. You've successfully connected your first cluster.

Infra works best when used with a team. Next, configure how users authenticate by connecting an identity provider, or add users directly by inviting them.