From Archives

Install Vector from pre-compiled archives

Before proceeding, please make sure Vector does not support your platform or package manager. These are recommended before installing from archives.

Downloads

Vector provides pre-built archives for popular target architectures. If you don't see an architecture, then we recommend building Vector from source.

Latest
Nightly

"Latest" represents the latest released version.

Architecture

Channel

Notes

x86_64-apple-darwin

latest

64-bit OSX (10.7+, Lion+)

unknown-linux-musl

latest

64-bit Linux with MUSL. Fully static, stripped, and LTO. (Recommended for Linux)

unknown-linux-gnu

latest

64-bit Linux (2.6.18+)

armv7-unknown-linux-gnueabihf ⚠️

latest

ARMv7 Linux

"Nightly" builds are released nightly and built from the master repo branch.

This release could have bugs or other issues. Please think carefully before using them over the "latest" alternatives.

Architecture

Channel

Notes

x86_64-apple-darwin

nightly

64-bit OSX (10.7+, Lion+)

unknown-linux-musl

nightly

64-bit Linux with MUSL. Fully static, stripped, and LTO. (Recommended for Linux)

unknown-linux-gnu

nightly

64-bit Linux (2.6.18+)

armv7-unknown-linux-gnueabihf ⚠️

nightly

ARMv7 Linux

⚠️ = This release is limited, it does not support on-disk buffers or the kafka sink. See the Limited Releases section for more info.

Installation

Copy the appropriate download link above and then proceed to download it:

curl -o <release-download-url> | tar -xzf --directory="vector" --strip-components=1

This will create a directory called vector. Let's change into that directory:

cd vector

Issuing the ls command shows the following directory structure:

LICENSE
README.md
bin/vector - The vector binary
config/vector.toml - Default Vector configuration
config/vector.spec.toml - Full Vector configuration specification
config/examples/* - A variety of configuration examples
etc/systemd/vector.service - Systemd service file
etc/init.d/vector - Init.d service file

To ensure vector is in your $PATH let's add it to your profile:

echo "export PATH=\"$(pwd)/vector/bin:\$PATH\"" >> $HOME/.profile
source $HOME/.profile

That's it! You can start vector with:

vector --config config/vector.toml

Proceed to configure Vector for your use case.

Configuring

The Vector configuration file is located at:

config/vector.toml

A full spec is located at config/vector.spec.toml and examples are located in config/vector/examples/*. You can learn more about configuring Vector in the Configuration section.

Data Directory

We highly recommend creating a data directory that Vector can use:

mkdir /var/lib/vector

And in your vector.toml file:

data_dir = "/var/lib/vector"

If you plan to run Vector under a separate user, be sure that the directory is writable by the vector process.

Limited Releases

For certain release targets Vector releases limited builds. These builds lack the following features:

  1. On-disk buffers.

The reason these features are not included is due to the libraries required to power them. Specifically, we use leveldb and rdkafka to power these features. Unfortunately, compiling and/or statically linking these libraries has proven to be a challenge. This is something we are working to resolve. You can track progress on issue 546.

Service Managers

Vector archives ship with service files in case you need them:

Init.d

To install Vector into Init.d run:

cp -a etc/init.d/vector /etc/init.d

Systemd

To install Vector into Systemd run:

cp -a etc/systemd/vector /etc/systemd/system

Updating

Simply follow the same installation instructions above.