Skip to main content

Marketplace page

Sidebar → Marketplace. Browse + install + publish chart packages.

Grid view​

Default landing — cards arranged in a grid with filter rail.

Each card:

  • Icon + name + slug
  • Description (truncated)
  • Category badges (coloured chips from the global taxonomy)
  • Version count
  • Hover state shows the latest version + last published timestamp

Filter rail (left):

  • Search (by name + description)
  • Categories (multi-select chips)
  • Source (Org-scoped / Globally shared) — only when license has MaxPublicMarketplacePackages > 0

Card click → Detail page​

Overview​

  • Description + readme (if shipped)
  • Source registry + chart_ref
  • Categories
  • Image registries linked (if any)
  • Install primary CTA → opens install drawer
  • Edit (when you have marketplace:update) → opens edit drawer
  • Delete (when you have marketplace:delete)

Versions tab​

All published versions, newest first:

ColumnMeaning
Versionsemver of the version row
Chart versionwhat helm sees
Publishedtimestamp
Default valuespreview link → modal with the YAML
Form schema"Yes" / "No" — whether this version ships x-form-schemas
ActionsEdit / Delete the version

The Add version CTA is at the top right (perm-gated).

Image Registries tab​

m2m link to extra helm_registries rows whose creds become imagePullSecrets on install. See How-to: add a helm registry.

Install drawer​

Three sections:

  1. Target — edge instance + namespace + release name
  2. Version — picks from versions tab
  3. Values — Form view (when x-form-schemas is shipped) or YAML view; toggle at the top

Submit. See How-to: install an application.

Add Package drawer​

  • Name + slug + description + icon URL + categories
  • Source — pick a registered registry + chart name OR enter a manual chart_ref
  • First version (optional) — same fields as the Add Version drawer; lets you publish v0.0.1 in one go

Submit → package row appears in the grid.

Add Version drawer​

  • Version + chart version
  • Default values (YAML) — empty is fine; helm chart defaults apply otherwise
  • Form schema (x-form-schemas) — JSON Schema + UI hints; see How-to: publish a marketplace package

Global marketplace (super-admin)​

Admin → Marketplace mirrors this page but operates on org_id IS NULL rows. Only renders when the license has MaxPublicMarketplacePackages > 0. Globally shared packages appear in every org's marketplace grid alongside their own org-scoped ones.

Empty state​

"No packages yet" with a Publish your first package CTA (when you have marketplace:create). On a fresh install this nudges admins to seed the catalog.

See also​