Documentação
Como implantar. Como operar. Como sair.
A documentação completa — cada endpoint, cada imagem suportada, cada código de erro. Sem marketing, sem paternalismo.
Crie uma conta
Email e senha. Sem telefone, sem documento. Sessões persistentes de 30 dias, revogáveis nas configurações.
Abasteça seu saldo
Envie qualquer moeda suportada para um endereço de uso único. Creditamos o equivalente em USD pela cotação do momento em que o depósito é confirmado.
Implante seu primeiro servidor
Escolha um plano, uma região, uma imagem de SO, cole uma chave SSH. O provisionamento leva 30–90 segundos.
Conecte via SSH
Somente por chave por padrão. Entre como root com o IPv4 do painel.
Faturamento e saldo
Saldo, recarga e o modelo de cobrança diária.
| Moeda | Depósito mínimo | Confirmações | Espera típica |
|---|---|---|---|
| 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 |
Fluxo de recarga: escolha uma moeda e um valor — geramos um endereço de uso único e travamos a cotação por 30 minutos. Uma vez confirmado, seu saldo é creditado pela cotação travada.
Cobrança diária: você é cobrado uma vez por dia UTC pelo custo proporcional de cada servidor ligado. Se o saldo não cobrir, o servidor é marcado como suspended e destruído após 7 dias de carência.
Ciclo de vida do servidor
Implantar, reiniciar, reinstalar, resgatar, destruir.
provisioningEstamos alocando a VM. 30–90 segundos.
installingA imagem do SO está sendo gravada e o cloud-init está em execução.
runningServidor no ar; SSH acessível.
stoppedDesligado normalmente. Disco e IP continuam alocados e faturados.
suspendedSaldo ficou negativo. Desligado, inacessível. 7 dias de carência.
Sistemas operacionais
Catálogo de imagens.
| Família | Versões | 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 (compatível RHEL) | 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 |
| ISO personalizada | upload ≤ 4 GB | qualquer | custom |
Referência da API
REST sobre HTTPS, JSON entra, JSON sai.
URL base https://api.noctisnode.com/v1 · Autenticação por token Bearer via Authorization: Bearer <token>
| Método | Caminho | Descrição |
|---|---|---|
GET | /servers | Lista seus servidores (paginado). |
POST | /servers | Cria um servidor. Retorna em estado provisioning. |
DELETE | /servers/{id} | Destrói um servidor. Irreversível. |
POST | /servers/{id}/reboot | Reinicialização suave. Use ?hard=true para ciclo completo de energia. |
POST | /servers/{id}/rebuild | Reinstala a partir de uma imagem. Destrói os dados do disco. |
POST | /servers/{id}/rescue | Inicializa na ISO de resgate (Alpine, 4 GB tmpfs). |
POST | /servers/{id}/rdns | Define o DNS reverso. |
GET | /servers/{id}/metrics | Consolidado de 30 dias de CPU/RAM/disco/banda. |
GET | /images | Lista as imagens de SO disponíveis. |
GET | /regions | Lista regiões e disponibilidade. |
GET | /plans | Lista planos com preços. |
POST | /billing/topup | Gera um endereço de depósito de uso único. |
GET | /billing/ledger | Histórico de transações. |