apso login
Authenticate with APSO Cloud to enable cloud features.
Usage
apso login
apso login --token <api-token>Description
Opens your default browser to complete OAuth authentication with APSO Cloud. Once authenticated, credentials are stored locally in ~/.apso/credentials.json.
If the browser does not open automatically, the CLI prints the authorization URL so you can open it manually.
Authentication is required for:
- Creating projects linked to the platform (
apso init) - Deploying to APSO Cloud (
apso deploy) - Schema sync commands (
apso schema push,apso schema pull) - Linking projects (
apso link)
Options
| Option | Description |
|---|---|
-t, --token <token> | Use an API token directly (for CI/CD) |
Examples
Standard Login
apso login
# Opens browser for authentication
# After completing login:
# âś“ Successfully logged in as user@example.comToken-Based Login (CI/CD)
For CI/CD environments or servers without a browser, use an API token:
apso login --token your-api-token
# âś“ Logged in as user@example.comVerifying Authentication
Check your authentication status:
apso whoamiLogging Out
Clear stored credentials:
apso logoutTroubleshooting
Browser Does Not Open
The CLI prints the authorization URL to the terminal. Copy and paste it into any browser to complete authentication.
”Invalid credentials” Error
- Log out first:
apso logout - Try again:
apso login - Confirm your APSO Cloud account is active
Session Expired
OAuth sessions expire after a period of inactivity. Run apso login again to re-authenticate. The CLI automatically refreshes tokens when possible.
Last updated on