# Install auditbeat with Homebrew, chocolatey, Nix

Lightweight Shipper for Audit Data. Version 9.4.3 via Homebrew; verified 2026-06-30.

## Install

```sh
sudo av install brew:auditbeat
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install auditbeat
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#auditbeat
```

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

### Windows

- Chocolatey (92%):

```sh
choco install auditbeat
```

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

## Package facts

- **Package key:** brew:auditbeat
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/auditbeat>
- **Version:** 9.4.3
- **Source summary:** Lightweight Shipper for Audit Data
- **Homepage:** <https://www.elastic.co/beats/auditbeat>
- **Repository:** <https://github.com/elastic/beats>
- **Upstream docs:** <https://www.elastic.co/docs/reference/beats/auditbeat>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/elastic/beats.git>
- **Last updated:** 2026-06-30T18:01:09Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- auditbeat (cli)
- auditbeat (alias)

## Build dependencies

- go
- mage

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

Auditbeat is Elastic's lightweight Beat for audit and security event collection. It ships operating-system audit data, Linux Audit Framework events, and file integrity signals into the Elastic Stack, making it part CLI daemon, part security telemetry collector, and part package-managed agent.

### Project history

Auditbeat lives in the Elastic Beats monorepo, which GitHub reports as created in 2014 for lightweight shippers for Elasticsearch and Logstash. The official docs describe Auditbeat as an Elastic Beat based on the libbeat framework.

The Beats repository history shows Auditbeat was initially added on 2017-06-26 in commit 4ad2066, described as migrating the audit module from Metricbeat into its own Beat. Beats 6.0.0 was published later in 2017, putting Auditbeat into the 6.x era of the Beats family.

### Adoption history

Auditbeat's adoption path followed the Beats model: install a small agent on servers, configure modules and outputs, and centralize events in Elasticsearch or related Elastic deployments. The supplied package-manager facts show Homebrew, Chocolatey, and Nix packaging, while Elastic's own directory-layout docs cover deb, rpm, Docker, and archive installations.

### How it is used

The official docs describe Auditbeat as a shipper that audits user and process activity, collects Linux Audit Framework events, and detects changes to critical files such as binaries and configuration files. Operators edit auditbeat.yml, set paths and outputs, optionally store secrets in an Auditbeat keystore, and run the service as part of an Elastic ingestion pipeline.

### Why package nerds care

Auditbeat matters to package people because it is not just a command but a service with config, data, log, module, keystore, and platform-specific installation layout expectations. Correct packaging decides whether auditbeat.yml, path.data, systemd units, Docker defaults, and secure settings land where Elastic's docs say they should.

### Timeline

- 2014: Elastic Beats repository was created.
- 2017: Auditbeat was initially added by migrating the audit module from Metricbeat into its own Beat.
- 2017: Beats 6.0.0 was published.
- 2026: Elastic's current docs list Auditbeat reference material for Elastic Stack and Elastic Cloud Serverless.

### Related projects

- Auditbeat is related to libbeat and the wider Beats family, especially Metricbeat because its initial audit module was migrated from Metricbeat. It is also part of Elastic's ingestion tooling alongside newer Elastic Agent workflows.

### Sources

- <https://api.github.com/repos/elastic/beats>
- <https://api.github.com/repositories/16554739/commits?path=auditbeat>
- <https://www.elastic.co/docs/reference/beats/auditbeat>
- <https://www.elastic.co/docs/reference/beats/auditbeat/configuring-howto-auditbeat>
- <https://www.elastic.co/docs/reference/beats/auditbeat/directory-layout>
- <https://www.elastic.co/docs/reference/beats/auditbeat/keystore>


## 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/auditbeat/auditbeat.yml, /usr/share/auditbeat/auditbeat.yml, {extract.path}/auditbeat.yml

## Credential files

- Unix: ${path.data}/auditbeat.keystore
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** auditbeat
- **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 - auditbeat: normalized package name match | nixpkgs package indexes: auditbeat from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- Chocolatey - auditbeat: normalized package name match | Chocolatey community package catalog: auditbeat from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','ansicon'


## 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.
- [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [mage](https://www.automicvault.com/pkg/brew/mage/) - Build dependency declared by Homebrew.
- [filebeat](https://www.automicvault.com/pkg/brew/filebeat/) - Shares the same upstream source repository.
- [heartbeat](https://www.automicvault.com/pkg/brew/heartbeat/) - Shares the same upstream source repository.
- [metricbeat](https://www.automicvault.com/pkg/brew/metricbeat/) - Shares the same upstream source repository.
- [packetbeat](https://www.automicvault.com/pkg/brew/packetbeat/) - Shares the same upstream source repository.
- [apachetop](https://www.automicvault.com/pkg/brew/apachetop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [atop](https://www.automicvault.com/pkg/brew/atop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [bpftop](https://www.automicvault.com/pkg/brew/bpftop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [collectd](https://www.automicvault.com/pkg/brew/collectd/) - Shares av.db curated category or tags: cli, monitoring, system.
- [conmon](https://www.automicvault.com/pkg/brew/conmon/) - Shares av.db curated category or tags: cli, monitoring, system.
- [ctop](https://www.automicvault.com/pkg/brew/ctop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [dfc](https://www.automicvault.com/pkg/brew/dfc/) - Shares av.db curated category or tags: cli, monitoring, system.

## Combined YAML source

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