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

# Manage Vertra Cloud from the terminal

> Install the vertra command on macOS, Linux or Windows and deploy, follow logs and manage your resources from the terminal.

## Installation

The CLI is a single binary with no dependencies — no Node.js required.

<Tabs>
  <Tab title="macOS and Linux">
    ```bash theme={null}
    curl -fsSL https://cli.vertracloud.app/install | sh
    ```
  </Tab>

  <Tab title="Windows">
    In PowerShell:

    ```powershell theme={null}
    irm https://cli.vertracloud.app/install | iex
    ```
  </Tab>
</Tabs>

The installer downloads the latest release for your system and processor (x64 or ARM), verifies its
SHA-256 checksum and adds the `vertra` command to your `PATH`. Open a new terminal and check it:

```bash theme={null}
vertra --version
```

To update, run the install command again. To install a specific version, set `VERTRA_VERSION`
(for example `VERTRA_VERSION=v0.2.0`) before running it. `VERTRA_INSTALL_DIR` changes where the
binary goes (default `~/.vertracloud/bin`, or `%USERPROFILE%\.vertracloud\bin` on Windows).

You can also download the binary for your platform directly from the
[releases page](https://github.com/vertracloud/cli/releases).

## Connecting your account

```bash theme={null}
vertra auth login
```

Paste an API key created on the API keys page of the dashboard. In CI and scripts, set the
`VERTRA_API_KEY` environment variable instead — it takes priority over the saved key.

## First deploy

```bash theme={null}
vertra doctor   # checks the project for problems before sending it
vertra deploy   # sends the current directory
vertra logs -f  # follows the application output live
```

Add `--json` to any command for structured output ready for automation.