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

# wandb docker

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <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>
    Source GitHub
  </a>;

<GitHubLink url="https://github.com/wandb/wandb/blob/v0.28.0/wandb/cli/cli.py#L2487" />

<div id="usage">
  ## Utilisation
</div>

```bash theme={null}
docker [OPTIONS] [DOCKER_RUN_ARGS]... [DOCKER_IMAGE]
```

<div id="description">
  ## Description
</div>

Exécutez du code dans un conteneur Docker avec W\&B configuré.

Démarrez un conteneur Docker, injectez la variable d’environnement WANDB\_DOCKERs
et montez le répertoire de travail actuel dans `/app` par
défaut. Injectez WANDB\_API\_KEY si vous êtes connecté. Redéfinissez le
point d’entrée du conteneur pour garantir que `wandb` est installé.

Passez des arguments supplémentaires pour les ajouter à `docker run` avant
le nom de l’image. Utilisez une image par défaut si aucune n’est spécifiée.

Utilisez `--jupyter` pour installer et démarrer JupyterLab sur le port 8888.
Activez automatiquement le runtime NVIDIA si NVIDIA Docker est
disponible sur l’hôte.

Docker doit être installé et en cours d’exécution sur la machine hôte.

Pour injecter des variables d’environnement W\&B dans une commande `docker run`
existante sans modifier le point d’entrée, utilisez `wandb docker-run`.

Par exemple, pour exécuter l’image par défaut et monter un jeu de données dans le conteneur :

```bash theme={null}
wandb docker -v /mnt/dataset:/app/data
```

Pour exécuter l’image par défaut et démarrer JupyterLab :

```bash theme={null}
wandb docker -v /mnt/dataset:/app/data --jupyter
```

Pour exécuter une image avec prise en charge du GPU à l’aide d’une commande d’entraînement :

```bash theme={null}
wandb docker wandb/deepo:keras-gpu --no-tty --cmd "python train.py"
```

<div id="arguments">
  ## Arguments
</div>

| Nom               | Par défaut | Type  |
| ----------------- | ---------- | ----- |
| `docker_run_args` | STR        | False |
| `docker_image`    | STR        | False |

<div id="options">
  ## Options
</div>

| Option      | Type               | Description                                                                                                     |
| ----------- | ------------------ | --------------------------------------------------------------------------------------------------------------- |
| `--nvidia`  | Indicateur booléen | Utilise le runtime nvidia ; la valeur par défaut est nvidia si nvidia-docker est présent. **Par défaut**: False |
| `--digest`  | Indicateur booléen | Affiche le digest de l'image, puis quitte. **Par défaut**: False                                                |
| `--jupyter` | Indicateur booléen | Exécute JupyterLab dans le conteneur. **Par défaut**: False                                                     |
| `--dir`     | STR                | Répertoire dans lequel monter le code dans le conteneur. **Par défaut**: /app                                   |
| `--no-dir`  | Indicateur booléen | Ne monte pas le répertoire actuel. **Par défaut**: False                                                        |
| `--shell`   | STR                | Shell avec lequel démarrer le conteneur. **Par défaut**: /bin/bash                                              |
| `--port`    | STR                | Port hôte auquel lier Jupyter. **Par défaut**: 8888                                                             |
| `--cmd`     | STR                | Commande à exécuter dans le conteneur. **Par défaut**: None                                                     |
| `--no-tty`  | Indicateur booléen | Exécute la commande sans tty. **Par défaut**: False                                                             |