> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suji.cloud/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>