Skip to content

Applications

The Applications module is the catalog of workloads you can deploy to your devices.

Who can access this: all roles can browse; deploying requires operator or admin rights (see Deployments).

Applications

You do not create applications by hand. The catalog is populated by registry sync: the platform syncs your Git and OCI registries and discovers application manifests and images. Each discovered version is indexed and immutable.

An application’s availability reflects its sources:

  • Available — at least one registry still provides it.
  • Source unavailable — every source registry has been removed.

The list shows each application’s name, vendor, category, latest version, the deployment profiles it supports (Docker Compose, Helm, Kubernetes, Podman), and when it was last updated. Filter by search, category, deployment profile, vendor, or availability.

Opening an application shows its metadata and description, a version history (each version flagged validated or not), and, for the selected version:

  • the deployment profile,
  • resource requirements (CPU, memory),
  • compatible devices,
  • the SHA-256 checksum and minimum Margo version,
  • and the source registries that provide it.

Click Deploy on an application (or Deploy To from a group) to open the 5-step deployment wizard:

  1. Application — confirm the application and version.
  2. Devices — select target devices, or target them by label/group.
  3. Parameters — override any configuration parameters the manifest exposes.
  4. Rollout — choose a strategy (immediate, canary, or rolling) and configure auto-promote/auto-rollback behavior.
  5. Summary — review and submit.

Submitting creates the deployment and takes you to its detail page. See Deployments for the full rollout reference.