Documentation

How to deploy. How to operate. How to leave.

The complete docs — every endpoint, every supported image, every error code. No marketing, no condescension.

Create an account

Email and password. No phone, no ID. Persistent 30-day sessions, revocable from settings.

Top up your balance

Send any supported coin to a one-time address. We credit the USD equivalent at the exchange rate at the moment your deposit confirms.

Deploy your first server

Pick a plan, a region, an OS image, paste an SSH key. Provisioning takes 30–90 seconds.

Connect via SSH

Key-based only by default. Log in as root with the IPv4 from the dashboard.

Billing & balance

Balance, top-up and the daily-charge model.

Coin	Min deposit	Confirmations	Typical wait
Bitcoin (BTC)	$10	2	~20 min
Monero (XMR)	$5	10	~20 min
Litecoin (LTC)	$5	6	~15 min
Ethereum (ETH)	$15	30	~6 min
USDT · TRC-20	$10	20	~1 min

Top-up flow: pick a coin and amount — we generate a one-time address and lock the rate for 30 minutes. Once confirmed, your balance is credited at the locked rate.

Daily charge: you are charged once per UTC day for the prorated cost of every running server. If your balance can't cover it, the server is marked suspended and destroyed after a 7-day grace period.

Server lifecycle

Deploy, reboot, rebuild, rescue, destroy.

provisioning

We are allocating the VM. 30–90 seconds.

installing

OS image is being written and cloud-init is running.

running

Server is up; SSH is reachable.

stopped

Gracefully shut down. Disk and IP still allocated and billed.

suspended

Balance went negative. Off, not reachable. 7-day grace period.

Operating systems

Image catalogue.

Family	Versions	Init	image_id
Debian	11 · 12 · 13	cloud-init	debian-13-minimal
Ubuntu	20.04 · 22.04 · 24.04 LTS	cloud-init	ubuntu-24.04
Alpine	3.18 · 3.19 · 3.20	cloud-init	alpine-3.20
Arch	rolling	cloud-init	arch-rolling
Fedora	40 · 41	cloud-init	fedora-41
Rocky	9 (RHEL-compat)	cloud-init	rocky-9
OpenBSD	7.5	autoinstall	openbsd-7.5
FreeBSD	14.0	cloud-init	freebsd-14
NixOS	24.05	nixos-rebuild	nixos-24.05
Custom ISO	upload ≤ 4 GB	any	custom

API reference

REST over HTTPS, JSON in, JSON out.

Base URL https://api.noctisnode.com/v1 · Bearer token auth via Authorization: Bearer <token>

Method	Path	Description
`GET`	/servers	List your servers (paginated).
`POST`	/servers	Create a server. Returns in provisioning state.
`DELETE`	/servers/{id}	Destroy a server. Irreversible.
`POST`	/servers/{id}/reboot	Soft reboot. Use ?hard=true to power-cycle.
`POST`	/servers/{id}/rebuild	Reinstall from an image. Destroys disk data.
`POST`	/servers/{id}/rescue	Boot into rescue ISO (Alpine, 4 GB tmpfs).
`POST`	/servers/{id}/rdns	Set reverse DNS.
`GET`	/servers/{id}/metrics	30-day CPU/RAM/disk/bandwidth rollup.
`GET`	/images	List available OS images.
`GET`	/regions	List regions and availability.
`GET`	/plans	List plans with pricing.
`POST`	/billing/topup	Generate a one-time deposit address.
`GET`	/billing/ledger	Transaction history.