login
Login to the Spice.ai Platform, or other services with sub-commands.
Usage​
spice login [command] [flags]
Flags​
-h,--helpPrint this help message-k,--keystring API key (for spice.ai)-o,--outputstring Where to store the resulting credentials. One ofenv(default; appends to a local.envfile),json(prints the credentials as JSON to stdout), orkeychain(stores them in the platform keychain, e.g. macOS Keychain).
--output applies to spice login itself (the Spice.ai login, with or without --key). The provider subcommands below always write to .env.
Available Commands​
abfsLogin to a Azure Storage AccountdatabricksLogin to a Databricks instancedelta-lakeConfigure credentials to access a Delta Lake tabledremioLogin to a Dremio instancepostgresLogin to a Postgres instances3Login to an s3 storagesharepointLogin to a Microsoft 365 sharepoint accountsnowflakeLogin to a Snowflake warehousesparkLogin to a Spark Connect remote
Provider flags​
Each provider subcommand writes the credentials it is given to the .env file. The flags of abfs, sharepoint, snowflake, and spark are described on the matching data connector pages.
dremio:-u,--username <USERNAME>and-p,--password <PASSWORD>, both required.postgres:-p,--password <PASSWORD>, required.s3:-k,--access-key <ACCESS_KEY>and-s,--access-secret <ACCESS_SECRET>, both required.databricks:-p,--token <TOKEN>for a personal access token, or--client-id <CLIENT_ID>and--client-secret <CLIENT_SECRET>for a service principal. For Delta Lake tables in cloud storage, also the storage flags listed fordelta-lake.delta-lake:--aws-region <AWS_REGION>,--aws-access-key-id <AWS_ACCESS_KEY_ID>, and--aws-secret-access-key <AWS_SECRET_ACCESS_KEY>for S3;--azure-storage-account-name <AZURE_STORAGE_ACCOUNT_NAME>and--azure-storage-access-key <AZURE_STORAGE_ACCESS_KEY>for Azure Blob Storage;--google-service-account-path <GOOGLE_SERVICE_ACCOUNT_PATH>for Google Cloud Storage.
Examples​
spice login
Additional Example​
spice login --key "<API_KEY>"
Browser Login Flow​
Running spice login without --key in an interactive terminal offers the same choices as spice cloud login. Login with a web browser runs spice cloud login subscription, which signs in to Spice Cloud with the OAuth 2.0 authorization code flow, PKCE (S256), and a loopback redirect:
- On the first sign-in, the CLI registers itself with Spice Cloud as a public client, with no client secret, and stores the client ID as
SPICE_SPICEAI_CLIENT_ID. Later sign-ins reuse it. - The CLI listens on
127.0.0.1on a random port and opens the Spice Cloud authorization page in a browser. Each sign-in uses a new PKCE verifier andstatevalue. - After the sign-in is approved in the browser, the browser is redirected to
http://127.0.0.1:<port>/callback. The CLI accepts the first redirect, closes the listener, and exchanges the authorization code for an access token and a refresh token.
The CLI asks only for the scopes its Spice Cloud commands use: apps:read apps:write apps:delete deployments:read deployments:write secrets:read secrets:write instances:write.
- The wait is bounded at 5 minutes. If the sign-in is not completed in that window, the command exits with
Timed out waiting for the browser sign-in. If the browser showed an error, run 'spice cloud logout', then 'spice login' again.When a shared user credential is stored,spice cloud logoutrefuses the default--scope active; runspice cloud logout --scope allinstead, which discards every stored Spice Cloud session and the stored OAuth client ID, so the next sign-in registers the CLI again. - A refused or mismatched response stops the sign-in. An
error=redirect, such as a denied sign-in, exits withSpice Cloud refused the sign-in: <detail>. A redirect whosestatedoes not match this sign-in is refused. - A browser on another machine. The loopback redirect only reaches a browser on the machine that runs the CLI. With
--device, the CLI prints the authorization URL instead of opening it. After signing in on another machine, paste the address of the page the browser was redirected to, which fails to load there, into the terminal. The CLI also reads a pasted address without--devicewhen stdin is a terminal.
The access token is short-lived. Before each spice cloud command except login and logout, the CLI renews a stored sign-in whose access token has less than 15 minutes left, using the refresh token stored beside it as SPICE_SPICEAI_REFRESH_TOKEN.
In Spice v2.4.3 and earlier, the browser login printed an auth code and polled a token exchange until the browser flow completed.
Credentials Stay on Their Origin​
The auth code, device code, and access token in these flows are sent in the request body, which an HTTP 307 or 308 redirect replays verbatim to the redirect target. The CLI's credential-bearing HTTP clients therefore follow redirects only within the same origin (scheme, host, and port), and refuse any hop that leaves it rather than forwarding the credential to another host. This applies to the spice login flows, the Spice Cloud client, and the CLI's own runtime and Cloud Platform requests made with --api-key.
An off-origin redirect surfaces as the 3xx response itself rather than as a transport error, so a misconfigured endpoint stays diagnosable.
spice cloud login​
Authenticate with the Spice Cloud Platform. See spice cloud for the rest of the Spice Cloud command surface.
Running spice cloud login with no subcommand offers two choices — Login with a web browser and Paste an access token — which run subscription and token respectively. The chooser needs an interactive terminal; non-interactive callers must name a method. api is not offered in the chooser and is always named explicitly.
Methods​
spice cloud login subscription​
Browser-based OAuth login flow. Automatically opens a browser for authentication.
spice cloud login subscription
Use --device to print the URL without opening a browser (useful for SSH/headless environments), then paste the address the browser was redirected to after signing in. See Browser Login Flow:
spice cloud login subscription --device
spice cloud login token​
Authenticate with a Spice Cloud access token. Alias: pat.
spice cloud login token --token "<TOKEN>"
Omit --token to enter the token at a secure prompt. Generate one at /account/tokens in the Spice Cloud portal.
The token can also be provided via the SPICE_CLOUD_PAT environment variable:
export SPICE_CLOUD_PAT="<TOKEN>"
spice cloud login token
spice cloud login api​
Authenticate using OAuth2 client credentials for CI/automation workflows.
spice cloud login api --client-id "<CLIENT_ID>" --client-secret "<CLIENT_SECRET>"
Credentials can also be provided via environment variables:
export SPICE_CLOUD_CLIENT_ID="<CLIENT_ID>"
export SPICE_CLOUD_CLIENT_SECRET="<CLIENT_SECRET>"
spice cloud login api
Environment Variables​
| Variable | Used by | Description |
|---|---|---|
SPICE_CLOUD_PAT | login token | Spice Cloud access token |
SPICE_CLOUD_CLIENT_ID | login api | OAuth2 client ID |
SPICE_CLOUD_CLIENT_SECRET | login api | OAuth2 client secret |
