Skip to content

auth login

Authenticate DataChain with Studio to save a client access token to DataChain configuration.

Synopsis

usage: datachain auth login [-h] [-v] [-q] [-H HOSTNAME] [-s SCOPES] [-n NAME] [--no-open] [--local]

Description

By default, this command authenticates DataChain with Studio using default scopes and assigns a random name as the token name. The authentication token will be used for subsequent Studio operations.

Options

  • -H HOSTNAME, --hostname HOSTNAME - The hostname of the Studio instance to authenticate with.
  • -s SCOPES, --scopes SCOPES - Authentication token scopes. Allowed scopes: EXPERIMENTS, DATASETS, MODELS. Defaults to all available scopes.
  • -n NAME, --name NAME - The name of the authentication token. It will be used to identify the token shown in Studio profile. Defaults to a random name.
  • --no-open - Use code-based authentication without browser. You will be presented with a user code to enter in the browser. DataChain will also use this if it cannot launch the browser on your behalf.
  • --local - Save the token in the local project config instead of the global configuration.
  • -h, --help - Show the help message and exit.
  • -v, --verbose - Be verbose.
  • -q, --quiet - Be quiet.

Examples

  1. Basic authentication with default settings: 

    datachain auth login

  2. Authenticate with specific scopes: 

    datachain auth login --scopes EXPERIMENTS,DATASETS

  3. Authenticate with a custom token name: 

    datachain auth login --name my-token

  4. Authenticate using code-based flow: 

    datachain auth login --no-open

  5. Save token locally for the project: 

    datachain auth login --local