Skip to content

Commit

Permalink
Clarify loading of kukeconfig for in-cluster headlamp installations
Browse files Browse the repository at this point in the history
Signed-off-by: Guillaume Berche <guillaume.berche@orange.com>
  • Loading branch information
gberche-orange committed Oct 31, 2024
1 parent 543bccb commit b50d9af
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions docs/installation/in-cluster/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,18 @@ you can run:
kubectl apply -f https://raw.githubusercontent.com/kinvolk/headlamp/main/kubernetes-headlamp.yaml
```

## Use a non-default kube config file

By default headlamp uses the default service account from the namespace it is deployed to, and generates a kubeconfig from it named `main`.

If you wish to use another specific non-default kubeconfig file, then you can do it by mouting it to the default location at `/home/headlamp/.config/Headlamp/kubeconfigs/config`, or
providing a custom path Headlamp with the ` -kubeconfig` argument or the KUBECONFIG env (through helm values.env)

### Use several kube config files

If you need to use more than one kubeconfig file at the same time, you can list
each config file path with a ":" separator in the KUBECONFIG env.

## Exposing Headlamp with an ingress server

With the instructions in the previous section, the Headlamp service should be
Expand Down Expand Up @@ -76,6 +88,8 @@ kubectl port-forward -n kube-system service/headlamp 8080:80

and then you can access `localhost:8080` in your browser.

##

## Accessing Headlamp

Once Headlamp is up and running, be sure to enable access to it either by creating
Expand Down

0 comments on commit b50d9af

Please sign in to comment.