This is a host command, used for managing machines you are renting out on Vast.ai.
SLA listing flags are not in the published CLI yet — prefer console Set Pricing → SLA, or REST; see SLA Offers. Volume/duration options (
-v, -z, -l) work today.Usage
Arguments
integer
required
ID of the machine to list.
Options
number
per gpu rental price in $/hour (price for active instances) (alias:
--price_gpu)number
storage price in $/GB/month (price for inactive instances), default: $0.10/GB/month (alias:
--price_disk)number
price for internet upload bandwidth in $/GB (alias:
--price_inetu)number
price for internet download bandwidth in $/GB (alias:
--price_inetd)number
per gpu minimum bid price floor in $/hour (alias:
--price_min_bid)number
Max long term prepay discount rate fraction, default: 0.4 (alias:
--discount_rate)integer
minimum amount of gpus (alias:
--min_chunk)string
contract offer expiration - the available until date (optional, in unix float timestamp or MM/DD/YYYY format) (alias:
--end_date)string
Updates end_date daily to be duration from current date. Cannot be combined with end_date. Format is:
n days, n weeks, n months, n years, or total intended duration in seconds. (alias: --duration)integer
Size for volume contract offer. Defaults to half of available disk. Set 0 to not create a volume contract offer. (alias:
--vol_size)number
Price for disk on volume contract offer. Defaults to price_disk. Invalid if vol_size is 0. (alias:
--vol_price)Description
Performs the same action as pressing the “LIST” button on the site https://cloud.vast.ai/host/machines. On the end date, the listing will expire and your machine will unlist. However, any existing rental contracts will still remain until ended by their owners. Once you list your machine and it is rented, it is extremely important that you don’t interfere with the machine in any way. If your machine has an active rental contract and then goes offline, crashes, or has performance problems, this can lower your marketplace reliability score (it recovers with continued good uptime — see Hosting overview). We strongly recommend you test the machine first and only list when ready. Always set an offer end date (-e) for SLA listings — see Offer End Date and SLA Offers.