Use Vector On Docker

Vector maintains the timberio/vector Docker images available on Docker Hub which come pre-installed with Vector and any recommended system dependencies. These images are available for x86_64, ARM64, and ARMv7 architectures.

Running

docker run timberio/vector:0.5.0-alpine
  • The vector binary is located at /usr/local/bin/vector, which should be in your $PATH.
  • The default configuration file is located at /etc/vector/vector.toml.

Configuring

The Vector Docker images ship with a default /etc/vector/vector.toml configuration file. To use your own configuration file:

  1. Create your own Vector configuration file and save it as vector.toml.

  2. Run the Vector Docker image with the following command:

    docker run \
    -v $PWD/vector.toml:/etc/vector/vector.toml:ro \
    timberio/vector:0.5.0-alpine

    Modify $PWD to the directory where you store your local vector.toml file.

Image Variants

alpine

This image is based on the alpine Docker image, which is a Linux distribution built around musl libc and BusyBox. It is considerably smaller in size than other Docker images and statically links libraries. This is the image we recommend due to it's small size and reliability.

docker run timberio/vector:0.5.0-alpine

debian

This image is based on the debian-slim image, which is a smaller, more compact variant of the debian image.

docker run timberio/vector:0.5.0-debian

Versions

Latest Version

Vector's Docker images include a special latest version that will be updated whenever Vector is released:

docker run timberio/vector:latest-alpine

Previous Versions

Previous versions can be accessed by their direct tag:

docker run timberio/vector:<X.X.X>-alpine

Nightlies

Vector's releases nightly versions that contain the latest changes.

docker run timberio/vector:nightly-alpine

Historical nightly versions are also available:

docker run timberio/vector:nightly-<YYYY-MM-DD>-alpine

Updating

Simply run with newer version in the tag:

docker run timberio/vector:X.X.X-alpine

Or pull the newest latest version:

docker pull timberio/vector:latest-alpine && \
docker run timberio/vector:latest-alpine

Or run with newer nightly date in the tag:

docker run timberio/vector:nightly-<YYYY-MM-DD>-alpine

Or pull the newest nightly version:

docker pull timberio/vector:nightly-alpine && \
docker run timberio/vector:nightly-alpine

Source Files

Vector's Docker source files are located in it's Github repo.