Addons
What this screen is for
The Addons tab manages the software installed on your clusters alongside your own workloads — ingress controllers, certificate managers, monitoring agents and similar. Fenwave keeps a catalog of addons it can install, tracks what is installed where, and can adopt addons that were installed outside the platform.
Before you start
| To do this | You need |
|---|---|
| See the tab | platform-settings.addon.read |
| Add an addon to the catalog | platform-settings.addon.create |
| Edit a catalog entry or upgrade an installation | platform-settings.addon.update |
| Remove a catalog entry | platform-settings.addon.delete |
At least one cluster must be registered, in Infrastructure › Clusters. The tab is organised around a cluster picker, so with no clusters there is nothing to show.
Addons moved here
This tab used to live under Infrastructure. That tab now shows only a notice pointing here.
Opening it
- Settings › Development
- Select the Addons tab.
The interface
📸 Screenshot Placeholder: The Addons tab. Mark: (1) the cluster picker, (2) the addons catalog panel, (3) the installations table, (4) a status chip, (5) the install and upgrade actions.
| # | Control | What it does | When you’d use it |
|---|---|---|---|
| 1 | Cluster picker | Chooses which cluster you are looking at | Always — everything below is per-cluster |
| 2 | Catalog panel | The addons Fenwave knows how to install | Installing something new |
| 3 | Installations table | What is actually installed on the selected cluster | Auditing, upgrading |
| 4 | Status chip | The health of one installation | Triage |
| 5 | Install / upgrade / register external | The three ways an installation appears here | See the walkthroughs |
Walkthroughs
Install an addon
Requires platform-settings.addon.update.
- Settings › Development › Addons.
- Pick the cluster.
- Choose the addon from the catalog panel and install it.
- Watch the status chip in the installations table until it settles.
Upgrade an installation
Requires platform-settings.addon.update.
- Pick the cluster and find the installation.
- Use the upgrade action and choose the target version.
- Watch the status.
Upgrade one cluster first and let it settle before doing the rest. Addons are shared infrastructure — an ingress controller upgrade that goes wrong takes every workload on that cluster with it.
Adopt an addon installed outside Fenwave
Requires platform-settings.addon.create.
Use register external to tell Fenwave about something already running on the cluster. This gives you visibility without reinstalling it. Registering does not take over its lifecycle — it records that it is there.
Scenario
A cluster is missing an ingress controller and nothing is reachable.
- Settings › Development › Addons, select the affected cluster.
- Look at the installations table. If the ingress controller is absent, it was never installed through Fenwave — which does not prove it is absent from the cluster, only that Fenwave does not know about it.
- Check the cluster itself, through
Cluster Console or your own tooling.
- Installed but unknown to Fenwave → register external so it appears here from now on.
- Genuinely absent → install it from the catalog panel.
- Wait for the status chip to settle before re-testing the application.
Step 2’s distinction matters. An empty installations table means “Fenwave has no record”, never “the cluster does not have it” — and treating the two as the same thing leads to installing a second copy of something already running.
When it doesn’t work
| Symptom | Cause | How to check | Fix |
|---|---|---|---|
| Tab is empty with nothing to pick | No cluster registered | Clusters | Register a cluster |
| An addon you know is running is not listed | It was installed outside Fenwave | Inspect the cluster directly | Use register external |
| Install starts, status never settles | The cluster cannot pull the addon, or lacks capacity | The status chip and the cluster’s own events | Resolve on the cluster, then retry |
| Upgrade action unavailable | Missing platform-settings.addon.update |
Access Explorer | Ask for a role granting it |
| Addons tab under Infrastructure shows only a notice | It moved here | — | Expected; use this tab |
Next
- Clusters — where addons are installed
- Integrations — third-party tools, as opposed to cluster software