> ## 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.

# Marketplace overview

> The Suji marketplace: vetted compose templates for one-click open-source app deploys.

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](https://github.com/suji-hq/suji-templates) — anyone can read it, propose a new app, or audit how an existing one is wired.

## Currently available

| App                                     | What it is                                                             | Exposable | Status |
| --------------------------------------- | ---------------------------------------------------------------------- | --------- | ------ |
| [Ghost](/marketplace/ghost)             | Modern blogging / newsletter platform                                  | ✅         | Stable |
| [Hermes Agent](/marketplace/hermes)     | Nous Research's autonomous AI agent (bring your own model key)         | ✅         | Stable |
| [Minecraft](/marketplace/minecraft)     | Managed Minecraft server with a web admin panel                        | ✅         | Stable |
| [n8n](/marketplace/n8n)                 | Workflow automation — visual node-based pipelines                      | ✅         | Stable |
| [NocoDB](/marketplace/nocodb)           | Open-source Airtable alternative                                       | ✅         | Stable |
| [OpenClaw](/marketplace/openclaw)       | Multi-channel AI messaging bot (Telegram / Discord / WhatsApp / Slack) | ✅         | Stable |
| [Plausible](/marketplace/plausible)     | Privacy-friendly web analytics                                         | ✅         | Stable |
| [Vaultwarden](/marketplace/vaultwarden) | Bitwarden-compatible password manager                                  | ✅         | Stable |
| [Wiki.js](/marketplace/wikijs)          | Open-source wiki / knowledge base                                      | ✅         | Stable |

Every app now has a full guide — see the per-app pages above.

## 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, runs `docker compose up -d`, and wires up the HTTPS ingress.
5. Status flips to `running`. The app is reachable at its `*.suji.fr` URL.

See [Install your first app](/getting-started/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](https://github.com/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

<CardGroup cols={2}>
  <Card title="OpenClaw guide" icon="message" href="/marketplace/openclaw">
    Full ops guide for the OpenClaw install.
  </Card>

  <Card title="App concept" icon="grid" href="/concepts/apps">
    What an "install" is and how it relates to the VM.
  </Card>
</CardGroup>