backend/frontend/charts: make in-cluster context name configurable

[iamhalje]

Summary

this PR makes Headlamp's in-cluster cluster name configurable and includes the selected cluster name in the browser tab title. (this help with to many tabs)

• In-cluster mode currently shows the cluster as main in the UI, this change allow overriding that name at runtime.
• Including the active cluster name in the title makes it easier to distinguish tabs when working with multiple headlamps tabs.

Related Issue

Fixes #4346

Changes

Backend:

• Add --in-cluster-context-name / HEADLAMP_CONFIG_IN_CLUSTER_CONTEXT_NAME to override the in-clustter context name (default main).

Frontend:

• Upgrade age title logic to include the current cluster name

Steps to Test

1. Run Headlamp in-clkuster mode with a custon cluster name, for example: headlamp-server --in-cluster --in-cluster-context-name=dev
2. Open the UI and veirfy the cluster name shows as dev instead of main.
3. Navigate between pages and veirfy the browser tab title is: <cluster> - <page> (or when page title is empty)

Screenshots (if applicable)

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: iamhalje / name: Dmitry Ponomaryov (3604645, 3720f72, 3a220ef, 58f7d8a, 6884653, 7f7c03f, b3605df, c7ccea1)

[Copilot]

Pull request overview

This PR makes the in-cluster context name configurable in Headlamp and enhances the browser tab title to include the active cluster name, addressing the need for better multi-cluster environment support.

Changes:

• Added --in-cluster-context-name CLI flag (default: "main") to customize the in-cluster context name
• Updated browser tab title format to include cluster name: <cluster> - <page>
• Renamed constant from InClusterContextName to DefaultInClusterContextName for clarity

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
frontend/src/components/App/RouteSwitcher.tsx	Modified PageTitle component to include cluster name in browser tab title
backend/pkg/kubeconfig/kubeconfig.go	Renamed constant and added contextName parameter to GetInClusterContext function with empty string handling
backend/pkg/headlampconfig/headlampConfig.go	Added InClusterContextName field to HeadlampCFG struct with documentation
backend/pkg/config/config.go	Added InClusterContextName field and CLI flag definition with default value "main"
backend/cmd/server.go	Passed InClusterContextName from config to HeadlampConfig
backend/cmd/headlamp.go	Added InClusterContextName field and passed it to GetInClusterContext function

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[illume]

This looks pretty good a first glance. Thanks a lot!

@iamhalje can you please rebase the PR against main branch? It seems like some older commits are mixed in here. Also please get rid of the merge commit.

Please see Commit Guidelines , we follow a linux kernel style of commit messages.

For example:

frontend: HomeButton: Fix so it navigates to home
backend: config: Add enable-dynamic-clusters flag

---

Seems there's some lint issue in the backend/ code (I think it is just a comment typo). You can run the linter locally like this:

npm run backend:lint
npm run backend:format

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[iamhalje]

@illume fixed, can rerun pipelines

[iamhalje]

@illume I can finish this today and fix remaining issues

[iamhalje]

@illume fixed all

[iamhalje]

@illume bump

[illume]

Thanks @iamhalje

It seems the chart test is failing in the github check.

You can run it locally like this:
make helm-template-test

Template test FAILED for ./charts/headlamp/values.yaml against ./charts/headlamp/tests/expected_templates/default.yaml:
--- ./charts/headlamp/tests/defaultvaluetest/rendered_templates.yaml	2026-01-26 16:18:43.176857421 +0000
+++ ./charts/headlamp/tests/expected_templates/default.yaml	2026-01-26 16:18:40.210852348 +0000
@@ -109,7 +109,6 @@
           env:
           args:
             - "-in-cluster"
-            - "-in-cluster-context-name=main"
             - "-plugins-dir=/headlamp/plugins"
             # Check if externalSecret is disabled
           ports:

Please squash or rebase this merge main commit out?

[iamhalje]

@illume helm-template-test passed

[iamhalje]

@illume what need to be done to get lgtm label?

[illume]

🎉 thanks!

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: iamhalje, illume

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [illume]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment