Marketplace overview

Documentation Index

Fetch the complete documentation index at: https://docs.suji.fr/llms.txt

Use this file to discover all available pages before exploring further.

The marketplace is the catalog of apps you can install on a Suji VM. Each entry is a vetted compose template with a fill-in-the-blank form for credentials, ports, and feature toggles. The full source lives in suji-hq/suji-templates — anyone can read it, propose a new app, or audit how an existing one is wired.

​

Currently available

Per-app deep guides are added as they reach “stable”. For now, OpenClaw has a full guide; the others have manifest-level descriptions in the dashboard.

​

How an install works

1. You click Install on an app’s marketplace page.
2. You pick the VM to install on (must have free capacity).
3. You fill in the form — required secrets, optional toggles, subdomain suggestion.
4. Suji renders the compose, ships it to your VM via cloud-agent, runs docker compose up -d, wires the Cloudflare Tunnel ingress.
5. Status flips to running. The app is reachable at its *.suji.fr URL.

See Install your first app for the step-by-step.

​

What’s vetted

Before an app lands in the catalog, the maintainer team checks:

• Image source — official upstream image or a trusted publisher.
• Pinned version — no :latest, no floating major (:1). Exact tag.
• Sane compose — no privileged: true, no network_mode: host, no host port bindings, no bind mounts outside the install’s volume.
• Form completeness — every required env in the compose is either user-input or auto-generated.
• Resource cap — deploy.resources.limits.memory set, ≤ recommended VM size.
• Documented license — real SPDX, not in the denylist.

If you spot a packaging bug (mount path wrong, env not propagating, image won’t pull) open an issue on the templates repo.

​

Adding a new app

The catalog is a public repo. To propose a new app:

1. Fork suji-hq/suji-templates.
2. Copy an existing app’s folder (the repo’s README is the contributor guide).
3. Edit the compose.yaml, manifest.yaml, and icon.svg for your app.
4. Open a PR — the team reviews against the checklist above.

Once merged, the marketplace updates within a few minutes via webhook.

​

Updates after install

Each app has an upgrade policy in its manifest:

• automatic — safe to upgrade in place. The dashboard offers a one-click upgrade when a new catalog version lands.
• breaking-changes-flagged — stateful apps with migrations or known break-points. The dashboard surfaces a diff for you to acknowledge first.

We don’t ever auto-apply upgrades without you clicking. Predictable > clever.

​

Next