VMs

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.

A VM (sometimes called an “instance” in the UI) is a dedicated Linux virtual machine. It’s where your apps run.

​

What’s on a VM

Every Suji VM ships with:

• Linux (current LTS) — kernel, package manager, the whole OS.
• Docker + docker compose — the runtime for marketplace apps.
• cloudflared — runs as a system container, registers a Cloudflare Tunnel for your VM, terminates inbound HTTPS for your apps.
• suji-net — the docker network that joins apps to cloudflared.
• A guest-agent — what powers the dashboard’s Terminal / Files / Logs / Metrics tabs. Cert-pinned HTTPS, only reachable from Suji’s control plane.
• Sensible firewall defaults — SSH (22) open, the guest-agent port locked to our control plane, everything else closed. You manage your own rules in the Firewall tab.

​

Sizes

Billing is hourly — monthly figures assume 24/7. Stopping a VM does not stop the bill: the cloud provider keeps the disk and IP reserved while it’s stopped, so the hourly rate continues. To stop paying for a VM you don’t need, destroy it (snapshot first if you want to come back). See Billing & credits. You can resize between sizes any time. Storage can only grow, never shrink. See Resize.

​

Regions

All regions are EU. Region is fixed for the life of the VM — to move, snapshot and restore into a new VM.

​

Network

• Public IPv4 + IPv6 — assigned at creation.
• *.suji.fr ingress — apps you mark “exposed” get a public HTTPS URL via Cloudflare Tunnel. No DNS to set up.
• Outbound: unrestricted except ports 25 and 465 (SMTP), which are blocked at the network layer to prevent abuse. Use 587 or an HTTP relay for mail.

See Network for IP / traffic details and Firewall for inbound rules.

​

Storage

• The VM’s storage is persistent — survives restarts, restorations, resize-ups.
• Each marketplace app gets its own named volume inside the VM for app data. Volumes survive container recreates and version upgrades. Uninstalling the app deletes its volume.
• Snapshots capture the full VM disk and live in EU-region object storage. See Snapshots.

​

Access

The web terminal lands you as root on the VM. The per-app terminal (pick an install from the selector) lands you inside that app’s container as the image’s USER.

​

Lifecycle

• Provisioning — 60–120 s from click to running.
• Stop / Start — graceful. Stop powers down the OS but does not pause billing — the cloud disk/IP stay reserved and accrue at the same hourly rate. Stop only for ops reasons, not to save money.
• Restart — soft reboot.
• Restore from snapshot — overwrites the disk from a snapshot.
• Destroy — irreversible. Apps and data go with it. Snapshots are retained for the retention window (see Snapshots).

​

Next