Skip to main content

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.

The behaviour when your credit balance gets low depends on whether auto-recharge is enabled. The two paths share the same terminal step but reach it differently.

Path A — Auto-recharge ON

Recommended. Adds a “suspension” grace window before any destruction.
1

Auto-recharge attempts a top-up

Balance drops below your configured threshold → Suji charges your card for the configured top-up amount. On success, balance refilled and life continues.
2

Card declines → VMs suspended

If the recharge attempt fails (card declined, expired, monthly cap, etc.), running VMs are powered off and flagged as suspended.Important: suspension does not stop billing. The cloud provider still charges Suji for the powered-off server (the disk and IP stay reserved), and we pass that cost through to your remaining credit. Your balance keeps decreasing.The user gets time equal to (remaining balance ÷ hourly rate) to fix the card.
3

Fix card → click Resume

Update your payment method, then click Resume. The VM powers back on in ~60 seconds. Same disk, same IP, same subdomain, no data loss.
4

Credit hits €0 → terminate + retain snapshot

If you don’t fix the card and credit reaches €0, the terminate flow runs (same as Path B below).

Path B — Auto-recharge OFF

No grace window. Balance hits €0 and the terminate flow runs immediately.
1

Balance approaches zero

Suji sends low-balance warning emails. The Billing page in the dashboard shows a persistent banner reminding you that auto-recharge is off.
2

Balance hits €0 → terminate + retain snapshot

The next metering pass after balance ≤ €0 runs terminate for every active VM in the org:
  1. Stop the VM gracefully.
  2. Take a cold snapshot of the disk.
  3. Mark the snapshot type='termination', retention 7 days.
  4. Delete the cloud server (provider billing stops here).
  5. The instance row is marked deprovisioning; the marketplace worker tears down the tunnel + DNS.
Your data lives in the termination snapshot for the retention window.
3

Within 7 days → top up + restore

Top up to a positive balance, then go to Snapshots in the dashboard and restore the termination snapshot into a new VM. The new VM gets a new IP but the data is intact.Note: snapshot storage continues to bill against your credit during retention. With no VM running, the burn rate is tiny (a few cents/GB/month). It can push your balance slightly negative — that’s expected, the top-up clears it.
4

After 7 days → snapshot deleted

The snapshot-retention-reaper runs hourly and deletes any snapshot whose retention has expired. Once that’s done, the snapshot is gone and your balance stops being debited for it.

Side-by-side

Auto-recharge ONAuto-recharge OFF
Card failsSuspension (VM powered off, billing continues)N/A — no card to fail
Balance hits €0Terminate (cold snapshot + delete VM)Terminate (cold snapshot + delete VM)
Snapshot retention7 days7 days
Cost during suspensionBilled at the regular hourly rate against your remaining creditN/A
Cost during snapshot retentionPer-GB-month storage rate (tiny — balance may go slightly negative)Same

Recommendation

Enable auto-recharge. It gives you the suspension grace window between “card failed” and “balance gone”, which is usually plenty of time to fix the card. Without it, a single missed top-up means immediate VM destruction (recoverable via snapshot for a week, but more work). You set this up in Billing → Payment methods → Auto-recharge. Pick a threshold (when to top up) and an amount (how much to add).

Notifications

  • “Balance is low” — when below your auto-recharge threshold (or below €2 if you don’t have one set).
  • “Auto-recharge failed — VMs suspended” — when path A’s suspension fires.
  • “Balance reached €0 — VMs terminated” — when termination fires (either path).
  • “Snapshot will be deleted in 24 hours” — one day before snapshot retention expires.
Add additional notification recipients in Organization → Notification preferences.

What about volumes and other billable resources?

Snapshot retention applies to instance snapshots. Detached volumes will get the same treatment (snapshot + delete + 7-day retention) — wiring is in progress; until then, detached volumes continue to bill until you delete them. Per-resource lifecycle rules at €0:
ResourceAt balance = €0Retention
Running / suspended VMCold snapshot + delete cloud server7 days
Snapshot (manual or migration)No automatic actionUntil user deletes
Snapshot (termination)N/A (this is the retention)7 days from creation
Outbound traffic overageAlready billed monthly; no retention concept
Detached volumeComing soon — snapshot + delete + 7-day retention7 days