Skip to main content

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 [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. 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.

Options

--browser
FLAG
Log in via browser using the OAuth device flow. Mutually exclusive with --api-key.
--api-key
TEXT
Baseten API key. If provided, the command runs in non-interactive mode. Mutually exclusive with --browser.
--remote
TEXT
default:"baseten"
Name of the remote to create or update in ~/.trussrc. Defaults to baseten.
Examples: Authenticate interactively and choose a method when prompted:
# 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:
truss login --api-key $BASETEN_API_KEY
# or with uvx:
uvx truss login --api-key $BASETEN_API_KEY
Log in via browser:
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`.