# Install telegraf with Homebrew, apk, chocolatey, MacPorts, Nix, scoop, winget, zypper

Plugin-driven server agent for collecting & reporting metrics. Version 1.39.1 via Homebrew; verified 2026-06-29.

## Install

```sh
sudo av install brew:telegraf
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install telegraf
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install telegraf
```

  Evidence: MacPorts ports tree: sysutils/telegraf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add telegraf
```

  Evidence: Alpine Linux edge package indexes: telegraf from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#telegraf
```

  Evidence: nixpkgs package indexes: pkgs/by-name/te/telegraf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install telegraf
```

  Evidence: openSUSE Tumbleweed package metadata: telegraf from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Chocolatey (92%):

```sh
choco install telegraf
```

  Evidence: Chocolatey community package catalog: telegraf from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','superputty'

- Scoop (92%):

```sh
scoop install main/telegraf
```

  Evidence: Scoop official bucket manifest trees: bucket/telegraf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id InfluxData.Telegraf -e
```

  Evidence: Windows Package Manager source index: InfluxData.Telegraf from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:telegraf
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/telegraf>
- **Version:** 1.39.1
- **Source summary:** Plugin-driven server agent for collecting & reporting metrics
- **Homepage:** <https://www.influxdata.com/time-series-platform/telegraf/>
- **Repository:** <https://github.com/influxdata/telegraf>
- **Upstream docs:** <https://docs.influxdata.com/telegraf/v1>
- **License:** MIT
- **Source archive:** <https://github.com/influxdata/telegraf/archive/refs/tags/v1.39.1.tar.gz>
- **Last updated:** 2026-06-29T19:36:58Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- telegraf (cli)
- telegraf (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Service: declared
- 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.39.1
- Package-manager updated: 2026-06-29
- Local data: ok
- Upstream repository: https://github.com/influxdata/telegraf
- Upstream latest detected: v1.39.1 (current)
## Project history and usage

Telegraf is InfluxData's plugin-driven collection agent for metrics, logs, and other telemetry. It became a standard package-manager install for observability setups because it is a single agent that can read many inputs, transform data, and write to many backends.

### Project history

InfluxData says it released Telegraf in 2015 as a lightweight, plugin-driven collection agent written in Go and designed around tagged measurements used by InfluxDB and OpenTSDB. The project grew inside the InfluxData ecosystem alongside the TICK stack.

The Telegraf 1.0 announcement described it as InfluxDB's native data collector and the first step of the TICK stack. At that point, the project had grown from a small number of input and output plugins into a broad open source agent with many contributors and plugin types.

### Adoption history

Telegraf's adoption followed its plugin model. Official docs describe input, output, aggregator, processor, and secretstore plugin categories, and InfluxData's product page now presents Telegraf as an open source agent with hundreds of community-tested plugins.

Because it could output beyond InfluxDB and integrate with infrastructure, applications, cloud services, message queues, and edge devices, Telegraf became common in package repositories across Unix, Windows, and container workflows.

### How it is used

Users normally generate or edit a TOML configuration, enable input and output plugins, and run the telegraf daemon as a service. Official docs show `telegraf config > telegraf.conf` as the standard way to generate a configuration file from the available plugins.

In package-manager culture, Telegraf is valued for being a boring, service-friendly collector: install it, place config under `/etc/telegraf`, drop fragments into `telegraf.d`, and let it feed the telemetry backend.

### Why package nerds care

Telegraf is significant because it turns a large observability integration surface into one package. Formula maintainers care about its build, plugin set, service files, config paths, and release cadence because those determine whether fleet installs behave predictably.

It also illustrates a packaging pattern common in infrastructure tooling: a single Go binary with a large plugin catalog and a stable text configuration format becomes the portable unit that package managers distribute.

### Timeline

- 2015: InfluxData releases Telegraf as a lightweight Go collection agent.
- 2016: Telegraf 1.0 GA is announced as InfluxDB's native data collector and the first step of the TICK stack.
- 2020s: Telegraf expands into a broad telemetry agent with hundreds of plugins and multi-backend output support.
- 2026: Telegraf v1.39.1 is published in the official GitHub releases.

### Related projects

- InfluxDB is Telegraf's original and primary ecosystem partner.
- Kapacitor and Chronograf are related TICK stack components.
- Prometheus, Grafana, OpenTelemetry collectors, and vendor agents occupy adjacent telemetry collection niches.

### Sources

- <https://docs.influxdata.com/telegraf/v1/configuration/>
- <https://docs.influxdata.com/telegraf/v1/plugins/>
- <https://github.com/influxdata/telegraf/releases/tag/v1.39.1>
- <https://www.influxdata.com/blog/announcing-telegraf-1-0-the-plugin-driven-agent-for-collecting-metrics/>
- <https://www.influxdata.com/blog/telegraf-go-collection-agent/>
- <https://www.influxdata.com/time-series-platform/telegraf/>


## 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

- Unix: /etc/telegraf/telegraf.conf, /etc/telegraf/telegraf.d

## Credential files

- Linux: /etc/default/telegraf, /etc/telegraf/secrets
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** telegraf
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - telegraf: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/telegraf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - telegraf - 1.37.0-r5: normalized package name match | Alpine Linux edge package indexes: telegraf from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A plugin-driven server agent for collecting & reporting metrics, part of the InfluxDB project | https://www.influxdata.com/time-series-platform/telegraf/
- apk - telegraf-doc - 1.37.0-r5: normalized package name match | Alpine Linux edge package indexes: telegraf-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A plugin-driven server agent for collecting & reporting metrics, part of the InfluxDB project (documentation) | https://www.influxdata.com/time-series-platform/telegraf/
- apk - telegraf-openrc - 1.37.0-r5: normalized package name match | Alpine Linux edge package indexes: telegraf-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A plugin-driven server agent for collecting & reporting metrics, part of the InfluxDB project (OpenRC init scripts) | https://www.influxdata.com/time-series-platform/telegraf/
- zypper - telegraf - 1.39.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: telegraf from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | The plugin-driven server agent for collecting & reporting metrics | https://github.com/influxdata/telegraf
- MacPorts - telegraf: normalized package name match | MacPorts ports tree: sysutils/telegraf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Chocolatey - telegraf: normalized package name match | Chocolatey community package catalog: telegraf from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','superputty'
- Scoop - main/telegraf: normalized package name match | Scoop official bucket manifest trees: bucket/telegraf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - InfluxData.Telegraf: normalized package name match | Windows Package Manager source index: InfluxData.Telegraf from https://cdn.winget.microsoft.com/cache/source.msix


## 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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [fluent-bit](https://www.automicvault.com/pkg/brew/fluent-bit/) - Shares av.db curated category or tags: agent, cli, data, metrics, observability.
- [cortex](https://www.automicvault.com/pkg/brew/cortex/) - Shares av.db curated category or tags: cli, data, metrics, observability.
- [filebeat](https://www.automicvault.com/pkg/brew/filebeat/) - Shares av.db curated category or tags: cli, data, observability.
- [influxdb](https://www.automicvault.com/pkg/brew/influxdb/) - Shares av.db curated category or tags: cli, data, metrics, time-series.
- [opentsdb](https://www.automicvault.com/pkg/brew/opentsdb/) - Shares av.db curated category or tags: cli, data, monitoring, time-series.
- [victoriametrics](https://www.automicvault.com/pkg/brew/victoriametrics/) - Shares av.db curated category or tags: cli, data, metrics, monitoring.
- [burrow](https://www.automicvault.com/pkg/brew/burrow/) - Shares av.db curated category or tags: cli, data, monitoring.
- [check_postgres](https://www.automicvault.com/pkg/brew/check-postgres/) - Shares av.db curated category or tags: cli, data, monitoring.
- [flux](https://www.automicvault.com/pkg/brew/flux/) - Local package facts share a topical domain. Shared terms: cli, data, series, time, time-series.
- [influxdb-cli](https://www.automicvault.com/pkg/brew/influxdb-cli/) - Local package facts share a topical domain. Shared terms: cli, data, series, time, time-series.
- [telegraf](https://www.automicvault.com/pkg/npm/telegraf/) - Same normalized package name in another local ecosystem.

## Combined YAML source

View the package source record on GitHub. [combined/telegraf.yml](https://github.com/automic-vault/db/blob/main/combined/telegraf.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
