Skip to main content
Before uploading, downloading, or reading metadata, sign in with dataerai auth.

Log in

dataerai auth login [flags]
FlagDescription
--serverBase URL of your DataErai deployment (https://<your-server>), or $DATAERAI_SERVER.
--client-idOAuth2 client ID, or $DATAERAI_CLIENT_ID.
--timeoutHow long to wait for the browser callback (default 5m).
--deviceUse the device authorization flow for environments without a browser.

Browser login

dataerai auth login --server https://<your-server>
This opens your browser, completes a secure (PKCE) sign-in, and prints Logged in as you@example.com.

Device login (headless)

On a server or CI runner with no browser, use the device flow:
dataerai auth login --device
The CLI prints a verification URL. Open it on any device with a browser, approve the request, and the CLI completes sign-in — no keys to copy.

Check status

dataerai auth status
# User:    you@example.com
# Token:   valid
# Expires: Tue, 06 May 2026 12:00:00 UTC
# Server:  https://<your-server>

Log out

dataerai auth logout
This removes the stored credential file.

Next steps

Commands

Upload, download, and manage metadata.