> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# wandb login

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "View source" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
      </>}
  </a>;

<GitHubLink compact url="https://github.com/wandb/wandb/blob/v0.30.0/wandb/cli/cli.py#L277" />

<h2 id="usage">
  Utilisation
</h2>

```bash theme={"system"}
login [OPTIONS] [KEY]...
```

<h2 id="description">
  Description
</h2>

Authentifiez votre machine auprès de W\&B.

Stocke une clé API en local pour l’authentification auprès des services W\&B.
Par défaut, les identifiants d’authentification sont stockés sans vérification côté serveur.

Si aucune clé API n’est fournie en argument, la commande recherche
les identifiants d’authentification dans l’ordre suivant :

1. La variable d’environnement WANDB\_API\_KEY

   2. Le paramètre api\_key dans un fichier de paramètres système ou de workspace (utilisez
      `wandb status` pour savoir quel fichier de paramètres est utilisé)

   3. Le fichier .netrc (\~/.netrc, \~/\_netrc ou le chemin défini par la variable d’environnement NETRC)

   4. Une invite interactive (si un TTY est disponible)

Pour les déploiements autohébergés ou en Cloud dédié, indiquez l’URL du serveur
avec `--host` ou définissez la variable d’environnement WANDB\_BASE\_URL.

Par exemple, pour vous connecter de manière interactive (une clé API vous est demandée) :

```bash theme={"system"}
wandb login
```

Pour vous connecter avec une clé API explicite (WANDB\_API\_KEY\_EXAMPLE) :

```bash theme={"system"}
wandb login WANDB_API_KEY_EXAMPLE
```

Pour vous connecter sans vérifier la clé API :

```bash theme={"system"}
wandb login --no-verify
```

Pour vous connecter au cloud public W\&B plutôt qu’à une instance autohébergée configurée :

```bash theme={"system"}
wandb login --cloud
```

Pour vous connecter à une instance W\&B autohébergée :

```bash theme={"system"}
wandb login --host https://my-wandb-server.example.com
```

Pour forcer l’affichage d’une nouvelle invite de connexion, même si vous êtes déjà authentifié :

```bash theme={"system"}
wandb login --relogin
```

<h2 id="arguments">
  Arguments
</h2>

| Nom | Par défaut | Type |
| - | - | - |
| `key` | STR | False |

<h2 id="options">
  Options
</h2>

| Option | Type | Description |
| - | - | - |
| `--cloud` | BOOL Flag | Se connecter au cloud public W\&B ([https://api.wandb.ai](https://api.wandb.ai)). Incompatible avec --host. **Par défaut** : False |
| `--host, --base-url` | STR | Se connecter à une instance spécifique du serveur W\&B à partir de son URL (par exemple, [https://my-wandb.example.com](https://my-wandb.example.com)). Incompatible avec --cloud. **Par défaut** : None |
| `--relogin` | BOOL Flag | Forcer l’affichage d’une nouvelle invite de connexion, sans tenir compte des identifiants d’authentification existants. **Par défaut** : None |
| `--verify` | BOOL Flag | Vérifier la clé API auprès de W\&B après l’avoir enregistrée. Si la vérification réussit, afficher la source des identifiants d’authentification et l’équipe par défaut. **Par défaut** : True |
