# kosa8 cloud login

Sign in to kosa8 Cloud: in your browser, or with an API key

At a terminal with no key given, offers to sign in in your browser (the same as
`kosa8 login`); otherwise checks the key with kosa8 Cloud (GET /v1/me). Either way
the key is kept in ~/.kosa8/cloud.json, readable only by you. The kosa8 desktop
app uses the same file, so it is signed in too.

The key comes from --key, else KOSA8_API_KEY, else a hidden prompt (or one line
on stdin, for a script). --key leaves the key in your shell history; prefer the
prompt. Make a key in the dashboard: https://app.kosa8.com/app#keys

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--key` | string | the API key (k8c_live_…); prefer the prompt, this stays in shell history |  |
| `--no-browser` | bool | for the browser sign-in: print the link instead of opening it |  |

## Example

```
  kosa8 cloud login
  printf %s "$KEY" | kosa8 cloud login
  KOSA8_API_KEY=k8c_live_… kosa8 cloud login
```

---
Source: https://docs.kosa8.com/reference/cloud-login/