Install

KubeMeridian is a standard Grafana app plugin. It is archived and not listed in the Grafana catalog, so you install it as an unsigned plugin from a release archive — the last one is v2.5.2.

Requirements

• Grafana ≥ 12.3 (built and tested on 13.x).
• A Prometheus-compatible datasource (kube-state-metrics + node-exporter + cAdvisor, e.g. kube-prometheus-stack) for the dashboards.
• Optional: Loki (logs), Tempo (traces), OpenCost (real cost).

Unsigned, from a release archive

# 1. allow the unsigned plugin (both ids — the bundled datasource needs it too)
GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=devopstech-kubemeridian-app,devopstech-kubemeridian-datasource

# 2. install the v2.5.2 release archive (Grafana's classic installer)
GF_INSTALL_PLUGINS='https://github.com/blackcheshire13/kubemeridian/releases/download/v2.5.2/devopstech-kubemeridian-app-2.5.2.zip;devopstech-kubemeridian-app'

Set both as environment variables on the Grafana instance, then restart Grafana. For an in-cluster (kube-prometheus-stack) Grafana, see Deploy in-cluster — it covers the Helm overlay, the read-only RBAC and datasource provisioning.

WARNING

A Grafana restart is required after the plugin is installed (plugin.json changes are read at startup).

Build it yourself

git clone https://github.com/blackcheshire13/kubemeridian
cd kubemeridian
npm ci
npm run build        # -> dist/
npm run server       # docker compose: Grafana with the plugin mounted (unsigned allowed)

Next: Connect your stack.