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

cloudstic auth login [options]

​
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

# Login to a Google auth entry
cloudstic auth login -name google-main

# Login to a OneDrive auth entry
cloudstic auth login -name onedrive-personal

​
Output

On success: 
Auth "google-main" is ready

​
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