# Install grafana-alloy with Homebrew, chocolatey, Nix, pacman OpenTelemetry Collector distribution with programmable pipelines. Version 1.17.1 via Homebrew; verified 2026-06-30. ## Install ```sh sudo av install brew:grafana-alloy ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install grafana-alloy ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#grafana-alloy ``` Evidence: nixpkgs package indexes: pkgs/by-name/gr/grafana-alloy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S grafana-alloy ``` Evidence: Arch Linux sync databases: grafana-alloy from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ### Windows - Chocolatey (92%): ```sh choco install grafana-alloy ``` Evidence: Chocolatey community package catalog: grafana-alloy from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','gpg4win-vanilla' ## Package facts - **Package key:** brew:grafana-alloy - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.17.1 - **Source summary:** OpenTelemetry Collector distribution with programmable pipelines - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-30T00:08:53Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Build dependencies - go - node ## Install behavior - Post-install hook: not defined - Service: declared - Caveats: Alloy configuration directory is $HOMEBREW_PREFIX/etc/grafana-alloy - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.17.1 - Package-manager updated: 2026-06-30 - Local data: ok - Upstream repository: https://github.com/grafana/alloy - Upstream latest detected: v1.17.1 (current) ## Project history and usage Grafana Alloy is Grafana Labs' open source distribution of the OpenTelemetry Collector, designed to run telemetry pipelines for metrics, logs, traces, and profiles while retaining first-class Prometheus-oriented pipeline support. ### Project history Alloy grew out of Grafana Agent and Grafana Agent Flow. Grafana Labs described Grafana Agent as a broad OSS telemetry agent introduced in 2020 for Prometheus-era collection problems, then positioned Alloy in 2024 as the successor that uses Agent Flow concepts while aligning with the OpenTelemetry Collector. The launch announcement emphasized compatibility with OTLP, OpenTelemetry Collector, and Prometheus Agent workflows. That made Alloy both a migration target for Grafana Agent users and a standalone collector for mixed observability environments. ### Adoption history Grafana Labs tied Alloy adoption to its recommendation that Grafana Agent users plan migrations before the Agent end-of-life date. Official migration documentation covers moving Agent Flow state directories and pipelines into Alloy layouts on Linux, macOS, Windows, and containers. The package became important in Homebrew-style environments because it packages a production telemetry collector as a single serviceable CLI/daemon with documented platform-specific configuration paths. ### How it is used Operators use Alloy to receive, transform, scrape, relabel, and export telemetry. Common package-manager usage is installing the binary, editing config.alloy, and running Alloy as a long-lived service that forwards data to Grafana Cloud, an LGTM stack, or other compatible backends. ### Why package nerds care Alloy matters to package maintainers because it sits at the convergence point of Prometheus scraping, OpenTelemetry Collector components, service management, and cross-platform config conventions. It replaced several collector choices with one packaged executable for many Grafana observability setups. ### Timeline - 2020: Grafana Agent rolled out as Grafana Labs' OSS telemetry agent. - 2024-04-09: Grafana Agent and Grafana Agent Operator entered long-term support in favor of Alloy. - 2024-04-10: Grafana Labs announced Grafana Alloy as an OpenTelemetry Collector distribution with Prometheus pipelines. - 2025-11-01: Grafana Agent was expected to reach end of life, making Alloy the migration target. ### Related projects - Grafana Agent and Grafana Agent Flow are Alloy's direct predecessors. - OpenTelemetry Collector, Prometheus Agent, Grafana, Loki, Tempo, and Mimir are adjacent projects in the same collector and backend ecosystem. ### Sources - - - - ## Security Notes formula declares a Homebrew service. - **Geiger risk:** orange / medium - formula declares a Homebrew service ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Linux: /etc/alloy/config.alloy - macOS: $(brew --prefix)/etc/alloy/config.alloy - Windows: %ProgramFiles%\GrafanaLabs\Alloy\config.alloy ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** grafana-alloy - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Conflicts With:** alloy-analyzer - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - grafana-alloy: normalized package name match | nixpkgs package indexes: pkgs/by-name/gr/grafana-alloy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - grafana-alloy - 1.13.2-1: normalized package name match | Arch Linux sync databases: grafana-alloy from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | OpenTelemetry Collector distribution with programmable pipelines | https://grafana.com/oss/alloy-opentelemetry-collector/ - Chocolatey - grafana-alloy: normalized package name match | Chocolatey community package catalog: grafana-alloy from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','gpg4win-vanilla' ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [node](https://www.automicvault.com/pkg/brew/node/) - Build dependency declared by Homebrew. - [alp](https://www.automicvault.com/pkg/brew/alp/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [grafana](https://www.automicvault.com/pkg/brew/grafana/) - Shares av.db curated category or tags: cli, developer-tools, metrics, observability. - [grafanactl](https://www.automicvault.com/pkg/brew/grafanactl/) - Shares av.db curated category or tags: cli, developer-tools, grafana, observability. - [humanlog](https://www.automicvault.com/pkg/brew/humanlog/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [otel-cli](https://www.automicvault.com/pkg/brew/otel-cli/) - Shares av.db curated category or tags: cli, developer-tools, observability, opentelemetry. - [stern](https://www.automicvault.com/pkg/brew/stern/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [analog](https://www.automicvault.com/pkg/brew/analog/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. - [angle-grinder](https://www.automicvault.com/pkg/brew/angle-grinder/) - Shares av.db curated category or tags: cli, developer-tools, logs, observability. ## Combined YAML source View the package source record on GitHub. [combined/grafana-alloy.yml](https://github.com/automic-vault/db/blob/main/combined/grafana-alloy.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph