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

# truss login

> Authenticate with Baseten.

```sh theme={"system"}
truss login [OPTIONS]
```

Authenticates with Baseten and stores the credential in `~/.trussrc` (and the OS keyring, when available).

`truss login` is an alias for [`truss auth login`](/reference/cli/truss/auth#login).
With no flags, it runs interactively and prompts you to choose between pasting an API key and logging in via browser.
To authenticate non-interactively, pass `--browser` or `--api-key`.

For details on how Truss stores credentials and how to manage multiple remotes, see [`truss auth`](/reference/cli/truss/auth).

### Options

{/* autogenerated by bin/generate_cli_docs.py for truss==0.18.2; do not edit */}}

<ParamField body="--browser">
  Log in via browser using the OAuth device flow. Mutually exclusive with `--api-key`.
</ParamField>

<ParamField body="--api-key" type="TEXT">
  Baseten [API key](/organization/api-keys). If provided, the command runs in non-interactive mode. Mutually exclusive with `--browser`.
</ParamField>

<ParamField body="--remote" type="TEXT">
  Name of the remote to create or update in `~/.trussrc`. Defaults to `baseten`.
</ParamField>

<ParamField body="--log" type="humanfriendly | W | WARNING | I | INFO | D | DEBUG" default="humanfriendly">
  Logging verbosity. `humanfriendly` (default) is pretty-printed; `INFO`, `DEBUG`, `WARNING` produce structured logs.
</ParamField>

<ParamField body="--non-interactive">
  Disable interactive prompts. Use in CI/automated contexts where stdin isn't a TTY.
</ParamField>

**Examples:**

Authenticate interactively and choose a method when prompted:

```bash theme={"system"}
# Using a local truss installation
truss login

# Using uvx (no installation required)
uvx truss login
```

You should see:

```
💻 Let's add a Baseten remote!
? How would you like to authenticate?
  Paste an API key
> Log in via browser (OAuth)
```

Authenticate non-interactively with an API key:

```bash theme={"system"}
truss login --api-key $BASETEN_API_KEY
# or with uvx:
uvx truss login --api-key $BASETEN_API_KEY
```

Log in via browser:

```bash theme={"system"}
truss login --browser
# or with uvx:
uvx truss login --browser
```

The CLI opens your browser to the verification page with your user code pre-filled. Approve the request, and the CLI automatically stores the OAuth tokens and prints:

```
🔓 Logged in to remote `baseten`.
```