Skip to main content
Trigger the OAuth authorization flow for a named auth entry. This opens your browser for authentication and saves the access token to the configured token file.

Usage

Options

-name
string
required
Auth reference name. Must match an existing entry in the profiles file.
-profiles-file
string
Path to the profiles YAML file.

Examples

Output

On success:

Credential Resolution

auth login resolves credentials in this order:
  1. Credentials stored in the auth entry (e.g., google_credentials path)
  2. Environment variables (GOOGLE_APPLICATION_CREDENTIALS, ONEDRIVE_CLIENT_ID)
  3. Built-in OAuth credentials (default)
You only need to run auth login once per auth entry. Tokens are automatically refreshed on subsequent backups.

See Also