> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai list machine

> Host command

list a machine for rent

<Note>This is a **host** command, used for managing machines you are renting out on Vast.ai.</Note>

## 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="-g" type="number">
  per gpu rental price in \$/hour  (price for active instances) (alias: `--price_gpu`)
</ParamField>

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

<ParamField path="-u" type="number">
  price for internet upload bandwidth in \$/GB (alias: `--price_inetu`)
</ParamField>

<ParamField path="-d" type="number">
  price for internet download bandwidth in \$/GB (alias: `--price_inetd`)
</ParamField>

<ParamField path="-b" type="number">
  per gpu minimum bid price floor in \$/hour (alias: `--price_min_bid`)
</ParamField>

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

<ParamField path="-m" type="integer">
  minimum amount of gpus (alias: `--min_chunk`)
</ParamField>

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

<ParamField path="-l" 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. (alias: `--duration`)
</ParamField>

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

<ParamField path="-z" type="number">
  Price for disk on volume contract offer. Defaults to price\_disk. Invalid if vol\_size is 0. (alias: `--vol_price`)
</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.

## Examples

```bash theme={null}
vastai list machine <ID>
```

## 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`) |