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

# Create your first VM

> Provision a dedicated cloud VM in ~60 seconds. Pick a size, pick a region, name it. Apps install on top of it separately.

A VM is a dedicated Linux machine that runs your apps. You can host one app on it, several apps on it, or use it as a general-purpose server.

You pay per hour for the VM itself (from your credit balance). Apps don't have a separate cost — they share the VM's CPU/memory/storage.

## Prerequisites

* A verified [Suji account](/getting-started/registration).
* Credit balance > €0 — top up from **Billing** in the dashboard before creating a VM.

## Create the VM

<Steps>
  <Step title="Open New Instance">
    Dashboard sidebar → **Instances** → **New Instance**.
  </Step>

  <Step title="Pick a name">
    Lower-case alphanumeric with hyphens, e.g. `prod-eu`, `my-vm`. The name is internal — public URLs come from the apps you later install on this VM, not from the VM itself.
  </Step>

  <Step title="Pick a size">
    Pricing is per hour, charged from your credit balance. Indicative monthly figures assume the VM runs 24/7.

    | Size   | vCPU | RAM   | Storage | ≈ / month |
    | ------ | ---- | ----- | ------- | --------- |
    | Small  | 2    | 4 GB  | 40 GB   | €12.99    |
    | Medium | 4    | 8 GB  | 80 GB   | €19.99    |
    | Large  | 8    | 16 GB | 160 GB  | €39.99    |
    | XL     | 16   | 32 GB | 320 GB  | €79.99    |

    You can resize later (see [Resize](/manage-vm/resize)).
  </Step>

  <Step title="Pick a region">
    All regions are EU.

    * **Falkenstein, Germany** (default)
    * **Nuremberg, Germany**
    * **Helsinki, Finland**

    The region is fixed for the life of the VM. To change it, snapshot and restore into a new VM.
  </Step>

  <Step title="Create">
    Click **Create Instance**. Provisioning takes 60–120 seconds. Status moves from `provisioning` → `running`.
  </Step>
</Steps>

## What you get

When the VM lands on `running`:

* A **public IPv4** and **IPv6** (Network tab in the instance detail page).
* A **Cloudflare Tunnel** wired up — apps installed later get `*.suji.fr` HTTPS URLs automatically.
* **SSH access** as the `root` user (find the key in **Settings → SSH Keys** before creation).
* A **web terminal** in the dashboard if you don't want to SSH.
* A **firewall** with sensible defaults (SSH open, everything else closed).

## Instance states

| Status                 | Meaning                                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `provisioning`         | VM is being created                                                                                                            |
| `running`              | VM is online and healthy                                                                                                       |
| `stopping` / `stopped` | You stopped it — OS is powered off, but the cloud disk/IP stay reserved and the hourly bill continues. Destroy to stop paying. |
| `starting`             | Coming back up                                                                                                                 |
| `rebuilding`           | Rebuilding after a restart or resize                                                                                           |
| `restoring`            | Mid-recovery from a snapshot                                                                                                   |
| `suspended`            | Powered off because auto-recharge failed — fix billing and resume                                                              |
| `error`                | Something went wrong — open Logs or contact support                                                                            |
| `deprovisioning`       | Being deleted                                                                                                                  |

## Next

<CardGroup cols={2}>
  <Card title="Install your first app" icon="grid" href="/getting-started/first-app">
    Pick an app from the marketplace and deploy it on the VM you just created.
  </Card>

  <Card title="VM management features" icon="server" href="/manage-vm/terminal">
    Terminal, files, logs, firewall, snapshots, resize.
  </Card>
</CardGroup>