# Install netdata with Homebrew, apk, MacPorts, Nix, pacman, apt

Diagnose infrastructure problems with metrics, visualizations & alarms. Version 2.10.3 via Homebrew; verified 2026-06-20.

## Install

```sh
sudo av install brew:netdata
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install netdata
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install netdata
```

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

### Linux

- apk (92%):

```sh
sudo apk add netdata
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#netdata
```

  Evidence: nixpkgs package indexes: netdata from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

- pacman (92%):

```sh
sudo pacman -S netdata
```

  Evidence: Arch Linux sync databases: netdata from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- Ubuntu apt (92%):

```sh
sudo apt install netdata
```

  Evidence: Ubuntu 24.04 LTS package indexes: netdata from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

## Package facts

- **Package key:** brew:netdata
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/netdata>
- **Version:** 2.10.3
- **Source summary:** Diagnose infrastructure problems with metrics, visualizations & alarms
- **Homepage:** <https://www.netdata.cloud/>
- **Repository:** <https://github.com/netdata/netdata>
- **Upstream docs:** <https://learn.netdata.cloud/docs>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://github.com/netdata/netdata/releases/download/v2.10.3/netdata-v2.10.3.tar.gz>
- **Last updated:** 2026-06-20T05:07:43Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- log2journal (cli)
- nd-mcp (cli)
- nd-run (cli)
- netdata (cli)
- netdata-claim.sh (cli)
- netdatacli (cli)
- systemd-cat-native (cli)
- log2journal (alias)
- nd-mcp (alias)
- nd-run (alias)
- netdata (alias)
- netdata-claim.sh (alias)
- netdatacli (alias)
- systemd-cat-native (alias)

## Dependencies

- abseil
- dlib
- json-c
- libuv
- libyaml
- lz4
- openssl@3
- pcre2
- protobuf
- snappy
- zstd

## Build dependencies

- cmake
- corrosion
- go
- pkgconf
- rust

## Uses from macOS

- curl

## 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: 2.10.3
- Package-manager updated: 2026-06-20
- Local data: ok
- Upstream repository: https://github.com/netdata/netdata
- info: No cached GitHub release or tag data was available.
## Project history and usage

Netdata is an open-source real-time infrastructure monitoring platform. Homebrew packages the agent and related commands for users who want per-second local metrics, dashboards, alerts, and troubleshooting without building the full C/Go/Rust/Python stack themselves.

### Project history

Netdata's own README and founder-written history trace the project to a 2013 operational monitoring problem: Costa Tsaousis was working at a company with cloud transaction failures and found existing monitoring too low-resolution, too expensive, and too hard to scale. He built a new tool around automatic discovery, high-resolution metrics, and fast visualization. That origin still explains the product's bias toward immediate local visibility rather than a query-first centralized monitoring workflow.

### Adoption history

The project moved from a Linux/sysadmin dashboard into a broader observability agent with machine-learning anomaly detection, parent-child aggregation, Netdata Cloud, Kubernetes deployment paths, and integrations. The GitHub README emphasizes per-second metrics, zero configuration, edge-based processing, and distributed operation. On July 1, 2026, Homebrew listed stable version 2.10.3 and 5,528 installs over 365 days.

### How it is used

Package users run the agent to inspect a host, VM, container machine, or workstation through the built-in web dashboard. Netdata documentation says the main configuration file is netdata.conf and that the running configuration can be reached from the agent on port 19999; the security docs warn that the local dashboard is exposed on port 19999 by default and describe bearer-token protection, disabling the local dashboard, or binding to private interfaces.

### Why package nerds care

Netdata is package-interesting because it is a full observability agent in a formula: lots of native dependencies, a daemon-style runtime, generated config, a local web UI, optional cloud claiming, and platform-specific service management. It is useful for quick host visibility, but maintainers and users need to treat the default dashboard exposure as an operational security detail, not just another CLI install.

### Timeline

- 2013: Netdata's origin story begins with Costa Tsaousis investigating cloud transaction failures and inadequate monitoring tools.
- 2019-12-18: Costa Tsaousis published a longer account of how Netdata was born.
- 2026-07-01: Homebrew listed stable version 2.10.3 and 5,528 installs over 365 days.

### Related projects

- Prometheus
- Grafana
- collectd
- Telegraf

### Sources

- <https://dev.to/jenniferbriston/redefining-monitoring-with-netdata-and-how-it-came-to-be-53ah>
- <https://formulae.brew.sh/formula/netdata>
- <https://github.com/netdata/netdata>
- <https://learn.netdata.cloud/docs/netdata-agent/configuration>
- <https://learn.netdata.cloud/docs/netdata-agent/configuration/securing-agents>


## Security Notes

formula declares a Homebrew service. infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service
- infrastructure mutation or orchestration signal


## 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/netdata/netdata.conf
- macOS: /usr/local/etc/netdata/netdata.conf, /opt/homebrew/etc/netdata/netdata.conf
## Source Database Details

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

## Other Package-Manager Records

- Nix - netdata: normalized package name match | nixpkgs package indexes: netdata from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- Ubuntu apt - netdata - 1.43.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: netdata from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | real-time performance monitoring (metapackage) | https://github.com/netdata/netdata
- Ubuntu apt - netdata-apache2 - 1.43.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: netdata-apache2 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | real-time performance monitoring (apache integration) | https://github.com/netdata/netdata
- Ubuntu apt - netdata-core - 1.43.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: netdata-core from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | real-time performance monitoring (core) | https://github.com/netdata/netdata
- Ubuntu apt - netdata-plugins-bash - 1.43.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: netdata-plugins-bash from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | real-time performance monitoring (bash plugins) | https://github.com/netdata/netdata
- Ubuntu apt - netdata-plugins-python - 1.43.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: netdata-plugins-python from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | real-time performance monitoring (python plugins) | https://github.com/netdata/netdata
- Ubuntu apt - netdata-web - 1.43.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: netdata-web from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | real-time performance monitoring (web) | https://github.com/netdata/netdata
- apk - netdata - 1.47.5-r22: normalized package name match | Alpine Linux edge package indexes: netdata from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Real-time performance monitoring | https://www.netdata.cloud/
- apk - netdata-go-plugins - 1.47.5-r22: normalized package name match | Alpine Linux edge package indexes: netdata-go-plugins from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Real-time performance monitoring (go plugins) | https://www.netdata.cloud/
- apk - netdata-openrc - 1.47.5-r22: normalized package name match | Alpine Linux edge package indexes: netdata-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Real-time performance monitoring (OpenRC init scripts) | https://www.netdata.cloud/
- apk - netdata-python - 1.47.5-r22: normalized package name match | Alpine Linux edge package indexes: netdata-python from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Real-time performance monitoring (python3 support) | https://www.netdata.cloud/
- pacman - netdata - 2.10.3-2: normalized package name match | Arch Linux sync databases: netdata from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Real-time performance monitoring, in the greatest possible detail, over the web | https://github.com/netdata/netdata
- MacPorts - netdata: normalized package name match | MacPorts ports tree: sysutils/netdata/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## 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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [lz4](https://www.automicvault.com/pkg/brew/lz4/) - Runtime dependency declared by Homebrew.
- [openssl@3](https://www.automicvault.com/pkg/brew/openssl-3/) - Runtime dependency declared by Homebrew.
- [pcre2](https://www.automicvault.com/pkg/brew/pcre2/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [zabbix](https://www.automicvault.com/pkg/brew/zabbix/) - Shares av.db curated category or tags: alerts, cli, infrastructure, metrics, monitoring.
- [collectd](https://www.automicvault.com/pkg/brew/collectd/) - Shares av.db curated category or tags: cli, metrics, monitoring, system.
- [ctop](https://www.automicvault.com/pkg/brew/ctop/) - Shares av.db curated category or tags: cli, metrics, monitoring, system.
- [mon](https://www.automicvault.com/pkg/brew/mon/) - Shares av.db curated category or tags: alerts, cli, monitoring, system.
- [nagios](https://www.automicvault.com/pkg/brew/nagios/) - Shares av.db curated category or tags: cli, infrastructure, monitoring, system.
- [node_exporter](https://www.automicvault.com/pkg/brew/node-exporter/) - Shares av.db curated category or tags: cli, metrics, monitoring, system.
- [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [duf](https://www.automicvault.com/pkg/brew/duf/) - Shares av.db curated category or tags: cli, monitoring, system.
- [syslog-ng](https://www.automicvault.com/pkg/brew/syslog-ng/) - Both packages work with overlapping file formats or content types. Shared terms: abseil, cli, json, json-c, openssl.
- [nagios-plugins](https://www.automicvault.com/pkg/brew/nagios-plugins/) - Local package facts share a topical domain. Shared terms: cli, monitoring, openssl, openssl-3, system.

## Combined YAML source

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