> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-docs-screenshot-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai metrics gpu-locations

> Host command

Show geographic distribution of GPUs on the marketplace

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

## Usage

```bash theme={null}
vastai metrics gpu-locations [OPTIONS]
```

## Options

<ParamField path="--verified" type="string">
  Filter by verification status (`true`, `false`, or `all`). Defaults to `all`.
</ParamField>

<ParamField path="--datacenter" type="string">
  Filter by datacenter hosting type (`true`, `false`, or `all`). Defaults to `all`.
</ParamField>

<ParamField path="--gpu" type="string">
  Comma-separated GPU names to filter by (e.g. `"RTX 4090, H100_SXM"`)
</ParamField>

<ParamField path="--rented" type="string">
  Filter by rental status (`true`, `false`, or `all`). Defaults to `all`.
</ParamField>

## Description

Returns the geographic distribution of GPUs across the Vast marketplace. Filtering is applied locally after fetching the dataset, so filter combinations do not affect server performance.

## Examples

```bash theme={null}
# All locations, unfiltered
vastai metrics gpu-locations

# Datacenter-verified only
vastai metrics gpu-locations --verified true --datacenter true

# Specific GPU types
vastai metrics gpu-locations --gpu "RTX 4090, H100_SXM"

# Only unrented GPUs
vastai metrics gpu-locations --rented false

# JSON output
vastai metrics gpu-locations --raw
```

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