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

# vastai set role

Set host role to view host-only commands

## Usage

```bash theme={null}
vastai set role host|client
```

## Arguments

<ParamField path="role" type="string" required>
  'host' or 'client'
  Allowed values: host, client
</ParamField>

## Description

This only changes what --help and tab completion display — every command
still runs regardless of role, since the server enforces real permissions.

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