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:
-
The WANDB_API_KEY environment variable
-
The api_key setting in a system or workspace settings file (use
wandb status to see which settings file is used)
-
The .netrc file (~/.netrc, ~/_netrc, or the NETRC env var path)
-
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 bypass verifying the API key:
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
Last modified on September 30, 2026