Documentazione

Come distribuire. Come gestire. Come partire.

La documentazione completa — ogni endpoint, ogni immagine supportata, ogni codice errore. Niente marketing, niente giri di parole.

Crea un account

Email e password. Niente telefono, niente documenti. Sessioni persistenti di 30 giorni, revocabili dalle impostazioni.

Ricarica il saldo

Invia qualsiasi valuta supportata a un indirizzo monouso. Accreditiamo l'equivalente in USD al tasso di cambio al momento della conferma del deposito.

Distribuisci il primo server

Scegli piano, regione, immagine OS, incolla una chiave SSH. Il provisioning richiede 30–90 secondi.

Collegati via SSH

Solo chiavi SSH per impostazione predefinita. Accedi come root con l'IPv4 dalla dashboard.

Fatturazione e saldo

Saldo, ricariche e modello di addebito giornaliero.

Valuta	Deposito minimo	Conferme	Attesa tipica
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

Flusso di ricarica: scegli valuta e importo — generiamo un indirizzo monouso e bloccchiamo il tasso per 30 minuti. Una volta confermato, il saldo viene accreditato al tasso bloccato.

Addebito giornaliero: viene addebitato una volta al giorno UTC il costo proporzionato di ogni server attivo. Se il saldo non basta, il server viene contrassegnato sospeso e distrutto dopo 7 giorni di tolleranza.

Ciclo di vita del server

Deploy, riavvio, reinstallazione, rescue, distruzione.

provisioning

Stiamo allocando la VM. 30–90 secondi.

installing

L'immagine OS viene scritta e cloud-init è in esecuzione.

running

Server attivo; SSH raggiungibile.

stopped

Arresto corretto. Disco e IP ancora allocati e fatturati.

suspended

Saldo andato in negativo. Spento, non raggiungibile. 7 giorni di tolleranza.

Sistemi operativi

Catalogo immagini.

Famiglia	Versioni	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

Riferimento API

REST over HTTPS, JSON dentro, JSON fuori.

URL base https://api.noctisnode.com/v1 · Auth con token Bearer via Authorization: Bearer <token>

Metodo	Percorso	Descrizione
`GET`	/servers	Elenca i tuoi server (impaginato).
`POST`	/servers	Crea un server. Restituisce stato provisioning.
`DELETE`	/servers/{id}	Distruggi un server. Irreversibile.
`POST`	/servers/{id}/reboot	Riavvio soft. Usa ?hard=true per il power-cycle.
`POST`	/servers/{id}/rebuild	Reinstalla da un'immagine. Distrugge i dati sul disco.
`POST`	/servers/{id}/rescue	Avvia ISO di rescue (Alpine, tmpfs 4 GB).
`POST`	/servers/{id}/rdns	Imposta DNS inverso.
`GET`	/servers/{id}/metrics	Rollup 30 giorni CPU/RAM/disco/banda.
`GET`	/images	Elenca immagini OS disponibili.
`GET`	/regions	Elenca regioni e disponibilità.
`GET`	/plans	Elenca piani con prezzi.
`POST`	/billing/topup	Genera un indirizzo di deposito monouso.
`GET`	/billing/ledger	Storico transazioni.