Docker

Docker Hub

Pre-built Docker images are available at dockerhub.com/tenzir.

Usage

All images expose a Docker volume at /var/lib/vast. That volume contains the database contents of VAST, i.e., the index and the archive.

The images use a Linux system user called vast with limited privileges. When you mount a directory for persistent data to /var/lib/vast, make sure the vast user inside the container can write to it.

Start VAST in a container and detach it to the background.

mkdir -p /var/lib/vast
docker run -dt --name=vast --rm -p 42000:42000 -v /var/lib/vast:/var/lib/vast tenzir/vast:latest start

Build an Image

We use BuildKit so we can have optional build stages in one Dockerfile. You can build a Docker image as follows:

DOCKER_BUILDKIT=1 docker build -t tenzir/vast:<TAG> --build-arg DOCKER_BUILD=build

The build process uses multiple layers and using --build-arg in combination with the environment variable DOCKER_BUILDKIT=1 allows to build some of these layers selectively. Use --build-arg DOCKER_BUILD=build for a full source build. In case you already have prebuilt compilates for Debian Buster (e.g., from a VAST CI build on GitHub) use --build-arg DOCKER_BUILD=prebuilt.

There also exists a build script that will tag and exported the Docker images as tar.gz files. The script accepts an optional parameter to build for a specific Docker tag.

./scripts/docker-build <TAG>