kvbox.sh
Guides

Usage

How long a box ran, as vCPU-hours and GiB-hours, and what it cost.

The server keeps a ledger of every box's state changes. kvbox vm usage sums it:

kvbox vm usage <box>
kvbox vm usage <box> --since 2026-10-01
kvbox vm usage <box> --json

The report is time spent running and stopped, in standby (paused) and hibernated, turned into vCPU-hours, RAM GiB-hours and disk GiB-hours. Standby earns RAM but no vCPU hours; hibernated and stopped earn disk only.

Cost

A host prices the hours when its config.json names a price list:

"pricing": { "currency": "EUR", "vcpuHour": 0.01, "ramGibHour": 0.005, "diskGibHour": 0.0001 }

With that in place the report ends with an estimated cost line. Through a control plane the prices are the control plane's.

On this page