Install Vector via Homebrew

Homebrew is a free and open-source package management system that manage software installation and management for Apple's macOS operating system and other supported Linux systems. This page will cover installing and managing Vector through the Homebrew package repository.


Vector daemon deployment strategyVector daemon deployment strategy
1. Your service logs to STDOUT
STDOUT follows the 12 factor principles.
2. STDOUT is captured
STDOUT is captured by your platform.
3. Vector collects & fans-out data
Vector collects data from your platform.

The agent role is designed to collect all data on a single host. Vector runs as a background process and interfaces with a host-level APIs for data collection. By default, Vector will collect logs via Vector's file source and metrics via the host_metrics source, but it is recommended to adjust your pipeline as necessary using Vector's sources, transforms, and sinks.

  1. Install Vector

    brew tap timberio/brew && brew install vector
  2. Configure Vector

  3. Restart Vector

    brew services restart vector
  4. Observe Vector

    tail -f /usr/local/var/log/vector.log
    explain this command


Vector is an end-to-end observability data pipeline designed to deploy under various roles. You mix and match these roles to create topologies. The intent is to make Vector as flexible as possible, allowing you to fluidly integrate Vector into your infrastructure over time. The deployment section demonstrates common Vector pipelines:

Common Deployment Topologies



brew services start vector
explain this command


brew services stop vector
explain this command


killall -s SIGHUP vector
explain this command


brew services restart vector
explain this command


tail -f /usr/local/var/log/vector.log
explain this command


brew update && brew upgrade vector
explain this command


brew remove vector
explain this command