Skip to main content
Apps are installed on top of an existing VM. If you haven’t created a VM yet, do that first, apps don’t get a VM by themselves.

​
Pick an app

1

Open the marketplace

Dashboard sidebar → Apps.
2

Choose an app

The catalog lists curated open-source apps. Click any card to read the description, required config, recommended VM size, and license. Some examples:
  • OpenClaw: Multi-channel AI messaging bot (Telegram / Discord / WhatsApp / Slack).
  • n8n: Workflow automation.
  • Ghost: Modern blogging platform.
  • NocoDB: Airtable-like no-code database.
  • Plausible: Privacy-friendly analytics.
  • Wiki.js: Open-source wiki.
  • Minecraft: Managed Minecraft server with a web admin panel.
See Marketplace overview for the full list and per-app guides.
3

Click Install

On the app’s detail page, click Install. You’ll be asked which VM to install on.

​
Fill in the install form

Every app’s form is different. It comes from the app’s manifest.yaml. Fields fall into a few common patterns:
  • Required secrets: API keys / tokens you have to supply (e.g. an Anthropic API key, a Telegram bot token).
  • Auto-generated secrets: gateway passwords / admin tokens that Suji fills with a random value if you leave them blank.
  • Selectors: pick channels / providers / modes.
  • Subdomain: for exposable apps. Suji prefills a unique suggestion based on the app’s subdomain_hint; you can edit it. Final URL: https://<your-subdomain>.suji.fr/.
All secret fields are encrypted at rest. They’re never shown back to you in plain text after save, only their existence.
Click Deploy. The install runs in the background. Status flows: installing → running.

​
After it’s running

The install detail page in the dashboard shows:
  • The public URL (if exposable).
  • The app’s logs, terminal, and files (the Logs / Terminal / Files tabs at the instance level. Pick the install from the selector).
  • The current version.
  • Restart, Upgrade, Uninstall actions.
  • Edit Install, change any field from the install form. Suji redeploys the container automatically.

​
Common patterns

For chatbots and integrations, you’ll configure a webhook in the third-party service (Telegram, Discord, WhatsApp Cloud API, Slack) pointing at your app’s https://<subdomain>.suji.fr/... URL. Set these up after the install reaches running: the URL only exists once the app is live.
A few apps (notably OpenClaw) require a token-bearing URL or device pairing for the first connection. Check the app’s marketplace page for any first-connect notes, for OpenClaw specifically, see its full guide.
The underlying network blocks outbound mail on ports 25 and 465 to prevent spam. If your app sends email, point it at a relay over port 587 (SendGrid / Mailgun / Postmark / Resend), adding a firewall rule won’t help.

​
Next

Marketplace overview

Browse all available apps and their guides.

Managing your VM

Operate the VM that hosts your apps, terminal, files, firewall.