Skip to content

login#

Authenticate with a Posit Connect server using OAuth 2.1. This opens a browser for interactive login (or uses --use-device-code for headless environments). Tokens are stored in the system keyring when available, with fallback to the local credential store.

Usage:

login [OPTIONS]

Options:

  -s, --server TEXT  The URL of the Posit Connect server.  [required]
  -n, --name TEXT    Nickname for the server (defaults to server hostname).
  -i, --insecure     Disable TLS certificate verification.
  -c, --cacert FILE  Path to a trusted CA certificate file for TLS.
  --use-device-code  Use device code flow for headless/non-interactive
                     environments.
  --client-id TEXT   OAuth client ID (skips Dynamic Client Registration).
  --no-set-default   Do not mark this server as the default after login.
  -v, --verbose      Enable verbose output. Use -vv for very verbose (debug)
                     output.
  --help             Show this message and exit.