Skip to main content

Usage

Description

Authenticate your machine with W&B. Store an API key locally for authenticating with W&B services. By default, credentials are stored without server-side verification. If no API key is provided as an argument, the command looks for credentials in the following order:
  1. The WANDB_API_KEY environment variable
  2. The api_key setting in a system or workspace settings file (use wandb status to see which settings file is used)
  3. The .netrc file (~/.netrc, ~/_netrc, or the NETRC env var path)
  4. An interactive prompt (if a TTY is available)
For self-hosted or dedicated cloud deployments, specify the server URL with --host, or set the WANDB_BASE_URL environment variable. For example, to log in interactively (prompts for API key):
To log in with an explicit API key (WANDB_API_KEY_EXAMPLE):
To log in and verify the API key is valid:
To log in to the W&B public cloud instead of a configured self-hosted instance:
To log in to a self-hosted W&B instance:
To force a new login prompt even if already authenticated:

Arguments

Options