Skip to main content
Start a local W&B server in a Docker container. Pull and run the wandb/local Docker image (local instance of the W&B server). Map the specified port on the host to port 8080 in the container and mount a persistent Docker volume named wandb to store data. If a newer image is available, notify the user to upgrade to the latest version (wandb server start --upgrade). If a container named wandb-local is already running, notify the user to stop it before starting a new one. Set the base_url setting to the local server URL so that W&B client calls use the local server. If no API key is found, prompt the user to log in. Requires Docker to be installed and running on the host machine.

Usage

wandb server start [OPTIONS]

Options

port

The host port to bind W&B server on.
FlagDefaultType
-p, --port8080STRING

env

Environment variables to pass to wandb/local Docker image.
FlagDefaultType
-e, --env[]STRING

daemon

Run the server in the background. Use —no-daemon to run in the foreground.
FlagDefaultType
--daemonTrueBOOL

upgrade

Docker image before starting. Stop any existing container.
FlagDefaultType
--upgradeFalseBOOL

edge

Use the bleeding edge
FlagDefaultType
--edgeFalseBOOL

help

Show this message and exit.
FlagDefaultType
--helpFalseBOOL

CLI Help

Usage: server start [OPTIONS]

  Start a local W&B server in a Docker container.

  Pull and run the `wandb/local` Docker image (local instance of the W&B
  server).

  Map the specified port on the host to port `8080` in the container and mount
  a persistent Docker volume named `wandb` to store data.

  If a newer image is available, notify the user to upgrade to the latest
  version (`wandb server start --upgrade`).

  If a container named `wandb-local` is already running, notify the user to
  stop it before starting a new one.

  Set the `base_url` setting to the local server URL so that W&B client calls
  use the local server. If no API key is found, prompt the user to log in.

  Requires Docker to be installed and running on the host machine.

Options:
  -p, --port TEXT         The host port to bind W&B server on.
  -e, --env TEXT          Environment variables to pass to wandb/local Docker
                          image.
  --daemon / --no-daemon  Run the server in the background. Use --no-daemon to
                          run in the foreground.
  --help                  Show this message and exit.