# prb auth command reference

Authenticate prb with Probo. This page documents **4 commands** under `prb auth`.

Flags and examples below come from the command definitions. A **Required** flag is explicitly marked required by Cobra; an unmarked flag can still be needed by runtime validation or a non-interactive workflow. Empty strings and empty lists are registered defaults, not sample values.

Every command also inherits the [global flags](/docs/developers/cli/commands#global-flags). Run `prb <command> --help` to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the [complete CLI command reference](/docs/developers/cli/commands) to browse another command.

## Commands

| Command                               | Description                     | Usage                | Source                                                                                               |
| ------------------------------------- | ------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------- |
| [`prb auth`](#prb-auth)               | Authenticate prb with Probo.    | `prb auth <command>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/auth.go#L32)          |
| [`prb auth login`](#prb-auth-login)   | Authenticate with a Probo host. | `prb auth login`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/login/login.go#L86)   |
| [`prb auth logout`](#prb-auth-logout) | Log out of a Probo host.        | `prb auth logout`    | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/logout/logout.go#L47) |
| [`prb auth status`](#prb-auth-status) | View authentication status.     | `prb auth status`    | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/status/status.go#L35) |

## prb auth

Authenticate prb with Probo.

### Usage

```text
prb auth <command>
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/auth.go#L32).

## prb auth login

Authenticate with a Probo host.

### Usage

```text
prb auth login
```

### Flags

| Flag         | Type   | Default | Required | Description                                      |
| ------------ | ------ | ------- | -------- | ------------------------------------------------ |
| `--hostname` | string | `""`    | —        | Probo hostname (e.g. eu.probo.com, us.probo.com) |
| `--org`      | string | `""`    | —        | Default organization ID                          |

### Examples

```bash
# Interactive login (select region, opens browser for device authorization)
prb auth login

# Login to Probo EU
prb auth login --hostname eu.probo.com

# Login to Probo US
prb auth login --hostname us.probo.com

# Login to a self-hosted instance
prb auth login --hostname probo.example.com
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/login/login.go#L86).

## prb auth logout

Log out of a Probo host.

### Usage

```text
prb auth logout
```

### Flags

| Flag         | Type   | Default | Required | Description                  |
| ------------ | ------ | ------- | -------- | ---------------------------- |
| `--hostname` | string | `""`    | —        | Probo hostname to log out of |

### Examples

```bash
# Log out of the active host
prb auth logout

# Log out of a specific host
prb auth logout --hostname app.getprobo.com
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/logout/logout.go#L47).

## prb auth status

View authentication status.

### Usage

```text
prb auth status
```

### Examples

```bash
# Show all configured hosts and their authentication status
prb auth status
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/auth/status/status.go#L35).