> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-398.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai list machine

\[Host] list a machine for rent

## Usage

```bash theme={null}
vastai list machine ID [options]
```

## Arguments

<ParamField path="id" type="integer" required>
  id of machine to list
</ParamField>

## Options

<ParamField path="--price_gpu" type="number">
  per gpu rental price in \$/hour  (price for active instances)
</ParamField>

<ParamField path="--price_disk" type="number">
  storage price in $/GB/month (price for inactive instances), default: $0.10/GB/month
</ParamField>

<ParamField path="--price_inetu" type="number">
  price for internet upload bandwidth in \$/GB
</ParamField>

<ParamField path="--price_inetd" type="number">
  price for internet download bandwidth in \$/GB
</ParamField>

<ParamField path="--price_min_bid" type="number">
  per gpu minimum bid price floor in \$/hour
</ParamField>

<ParamField path="--discount_rate" type="number">
  Max long term prepay discount rate fraction, default: 0.4
</ParamField>

<ParamField path="--min_chunk" type="integer" default="1">
  minimum amount of gpus (default: 1)
</ParamField>

<ParamField path="--end_date" type="string">
  contract offer expiration - the available until date (optional, in unix float timestamp or MM/DD/YYYY format)
</ParamField>

<ParamField path="--duration" type="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.
</ParamField>

<ParamField path="--vol_size" type="integer">
  Size for volume contract offer. Defaults to half of available disk. Set 0 to not create a volume contract offer.
</ParamField>

<ParamField path="--vol_price" type="number">
  Price for disk on volume contract offer. Defaults to price\_disk. Invalid if vol\_size is 0.
</ParamField>

## Description

Performs the same action as pressing the "LIST" button on the site [https://cloud.vast.ai/host/machines](https://cloud.vast.ai/host/machines).
On the end date the listing will expire and your machine will unlist. However any existing client jobs 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 client job and then goes offline, crashes, or has performance problems, this could permanently lower your reliability rating.
We strongly recommend you test the machine first and only list when ready.

Raising any resource price above the current contract price writes a
pending row to `pending_price_increases` for each affected client.
Clients review and accept those rows via the console or
`vastai show pending-price-increases`; auto-extend stops at the old
price until they accept.

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |