---
description: "Install the Verda CLI, authenticate with your API credentials, and run your first commands to deploy and inspect GPU resources straight from your terminal."
revision_date: 04.08.2026
---

# Getting Started

This guide walks you through authentication, your first commands, and useful configuration options.

!!! info
    For installation instructions, see the [Verda CLI overview](https://docs.verda.com/cli/).

***

#### Configure authentication

Run the interactive login wizard to save your credentials:

```bash
verda auth login
```

The wizard prompts you for your Client ID and Client Secret, then saves them to `~/.verda/credentials`.

To verify your credentials are configured correctly:

```bash
verda auth show
```

***

#### Credential resolution

The CLI resolves credentials in this order:

1. **CLI flags** — `--auth.client-id` and `--auth.client-secret`
2. **Config file** — `~/.verda/config.yaml`
3. **Environment variables** — `VERDA_CLIENT_ID` and `VERDA_CLIENT_SECRET`
4. **Credentials file** — `~/.verda/credentials`

For CI/CD pipelines, environment variables are recommended:

```bash
export VERDA_CLIENT_ID="your-client-id"
export VERDA_CLIENT_SECRET="your-client-secret"
```

***

#### Multiple profiles

You can store credentials for multiple accounts using profiles. Switch between them with:

```bash
verda auth use <profile-name>
```

***

#### Run your first command

Check what instance types are available:

```bash
verda instance-types
```

Or see available locations:

```bash
verda locations
```

To get an overview of your account including running instances, volumes, and costs:

```bash
verda status
```

***

#### Diagnose issues

If something isn't working, run the built-in diagnostic tool:

```bash
verda doctor
```

This checks your credentials, API reachability, authentication, CLI version, and directory permissions.

***

#### Shell completion

Generate shell completions for your shell:

=== "Bash"

    ```bash
    verda completion bash > /etc/bash_completion.d/verda
    ```

=== "Zsh"

    ```bash
    verda completion zsh > "${fpath[1]}/_verda"
    ```

=== "Fish"

    ```bash
    verda completion fish > ~/.config/fish/completions/verda.fish
    ```

***

#### Global flags

These flags are available on all commands:

| Flag | Description |
|------|-------------|
| `-o, --output` | Output format: `table`, `json`, or `yaml` (default: `table`) |
| `--agent` | Agent mode: JSON output, no prompts, structured errors |
| `--debug` | Enable debug output with API request/response details |
| `--timeout` | HTTP request timeout (default: 30s) |
| `--config` | Path to config file (default: `~/.verda/config.yaml`) |

***

#### Next steps

You're now ready to start managing Verda resources from the command line.

Next, explore:

* **[Instances](https://docs.verda.com/cli/instances/)** — provision and manage GPU and CPU instances
* **[Storage](https://docs.verda.com/cli/storage/)** — create and manage block volumes
* **[Resources](https://docs.verda.com/cli/resources/)** — manage SSH keys, startup scripts, and templates
* **[Cost & Status](https://docs.verda.com/cli/cost-and-status/)** — estimate costs and monitor your account