Compute Discovery (np compute)

Search and discover available bare metal compute hosts matching specific hardware specifications, regions, and pricing limits.

Syntax

np compute [options]

Options

Option	Short	Description	Default
`--cpu`	`-c`	Minimum CPU cores required	`1`
`--memory`	`-m`	Minimum RAM in gigabytes (GB)	`1`
`--storage`	`-s`	Minimum disk storage in gigabytes (GB)	`10`
`--max-price`	`-p`	Maximum monthly budget in USD	None
`--region`	`-r`	Filter by target region (e.g. `us-west-1`, `fmt1`)	None
`--datacenter`		Filter by datacenter facility code (e.g. `fmt1`)	None
`--status`		Filter by host status: `active`, `reservable`, `all`	`all` (shows active and reservable)
`--format`	`-f`	Output format (`table` or `json`)	`table`

Output Columns

The table output shows the full compute Host ID, lifecycle status, location, and the consolidated requested slice specifications (RAM/Disk/CPU) evaluated for pricing:

Column	Description
`Host ID`	Full, untruncated UUID of the compute host
`Status`	Lifecycle status: `active` (deployable immediately) or `reservable`
`Region`	Geographic region of the host
`Datacenter`	Specific facility code
`RAM/Disk/CPU`	Consolidated requested slice specs: RAM (GB) / Disk (GB) / CPU (Cores) (e.g. `1/10/5`)
`Price/hr ($)`	Estimated hourly USD rate
`Price/mo ($)`	Estimated monthly USD rate (~730 hours/month)

The RAM/Disk/CPU column reflects the requested resources corresponding to the slice price (e.g. 1/10/5 indicates 1 GB RAM, 10 GB Disk, 5 CPU cores), not the total bare metal capacity of the underlying host server. To view total host hardware capacity, use --format json.

Examples

# Discover active and reservable hosts with baseline slice specs (1 vCPU, 1 GB RAM, 10 GB Disk)
np compute

# Discover hosts with at least 4 vCPUs, 8 GB RAM, and 50 GB storage
np compute -c 4 -m 8 -s 50

# Filter for hosts with a monthly rate of $20 or less in us-west-1
np compute -c 2 -m 4 -s 20 -p 20 -r us-west-1

# Output machine-readable JSON for scripting
np compute -c 2 -m 4 -f json

Create Node

Deploy a new compute node onto discovered compute hosts.

List Nodes

View all active compute nodes.

Overview