Quickstart

This quickstart section will show you how to run a vantage6 network, comprising of a central server, three nodes, an algorithm store and a user interface, on your local machine.

Requirements

Make sure you have installed Python and a form of Kubernetes. These are required for all vantage6 components. Installation instructions are present, for instance, in the server requirements section.

If you are using Docker Desktop, you can simply :ref:`switch on Kubernetes <https://docs.docker.com/desktop/features/kubernetes/>`_. Otherwise, we recommend installing microk8s.

Installation

Create a virtual Python environment. We recommend using uv for package management. You can create and activate a Python environment with:

uv venv --python 3.13
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Then, install the vantage6 command line interface (CLI) by running:

uv pip install vantage6

Note

While vantage6 5.0.0 has not yet been released, you can install the latest version of the CLI by running:

uv pip install vantage6 --prerelease=allow

Start a local vantage6 network

In the Python environment where you installed the vantage6 CLI, you can easily set up a local vantage6 network by running the following command:

v6 sandbox new

This will start an interactive dialog that will ask you to provide a name for the network. Note that default settings are used - you can view custom options with v6 sandbox new --help.

The network is automatically started. Using the default settings, this will start up a server, three nodes, an algorithm store and a user interface. The nodes contain some test data about olympic medal winners. Note also that the server is coupled automatically to the community algorithm store, thereby making the community algorithms directly available to you.

You can now access the user interface by navigating to http://localhost:30760 in your browser and log in with the username admin and password admin. Enjoy!

Note

If you are using Windows or WSL with Docker Desktop to run your sandbox, the sandbox files are stored in a WSL folder. Unfortunately, this folder is deleted when you restart WSL or your machine itself. This means your sandbox will be lost.

Also, note that to run the sandbox from WSL, you need to install wslview so that WSL can initiate the authentication process in your browser. To install it, run:

sudo apt-get install wslview

Note

For those using Microk8s, we have seen networking issues when you move your machine to a different network, e.g. from home to work. What we found helped is to reset the certificates of your microk8s cluster, so that they no longer depend on an outdated IP address. To do this, run:

microk8s config > ~/.kube/config
kubectl config use-context microk8s
sudo microk8s refresh-certs --cert ca.crt

Stopping the network

Once you are done, you can stop and remove the network by running:

# Stop the network
v6 sandbox stop

# Remove the network permanently (clean up logs, configuration files, etc)
v6 sandbox remove

Note that you can always run v6 sandbox start to start the network again.