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

# tp login

> Log in, log out, and account status

## tp login

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
tp login --server https://<your TunePlane domain>   # Specify on first login; remembered afterward
tp login                                    # Browser authorization (default)
tp login --device-flow                      # Device-code login (SSH / no browser)
tp login --token <TOKEN>                    # Non-interactive (CI)
```

| Option          | Description                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------ |
| `-s, --server`  | TunePlane server address; if omitted, uses the last remembered value / the `TUNEPLANE_SERVER` environment variable |
| `--token`       | Log in directly with a service token, skipping the browser (for CI)                                                |
| `--device-flow` | Force the device-code flow                                                                                         |
| `--no-browser`  | Same as `--device-flow`                                                                                            |

Login state is written to `~/.tuneplane/` (permissions 0600). The browser flow uses OAuth + PKCE; when the platform is configured with OIDC (e.g. Casdoor), it automatically redirects to single sign-on.

<Frame caption="Console login. The same page is used when `tp login` opens a browser.">
  <img src="https://mintcdn.com/starforge/GatXR2rI5-_Vm4_H/images/console/login.png?fit=max&auto=format&n=GatXR2rI5-_Vm4_H&q=85&s=2306521111801b18e089d0ddd58a6667" alt="TunePlane console login" width="2160" height="1350" data-path="images/console/login.png" />
</Frame>

## tp logout

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
tp logout
```

Revokes the refresh token and clears the local login state.

## tp status

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
tp status
```

Outputs: current account and role, quotas (concurrent GPUs / jobs / daily GPU-hours), current usage, available hardware profiles, and the list of active jobs. Checking the watermark before submitting is a good habit.

## `tp login`

Log in to TunePlane

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
tp login [options]
```

| Option           | Description                                                                                         |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| `--server`, `-s` | TunePlane server address (default [https://tuneplane.gcoreinc.com](https://tuneplane.gcoreinc.com)) |
| `--token`        | Non-interactive login: use a service token (for CI)                                                 |
| `--device-flow`  | Force the device-code login (SSH / no browser)                                                      |
| `--no-browser`   | Do not open a browser (same as --device-flow)                                                       |