# Install asn with Homebrew, apk, apt, Nix

Organization lookup and server tool (ASN / IPv4 / IPv6 / Prefix / AS Path). Version 0.81.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:asn
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install asn
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add asn
```

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

- Debian apt (92%):

```sh
sudo apt install asn
```

  Evidence: Debian stable package indexes: asn from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#asn
```

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

## Package facts

- **Package key:** brew:asn
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/asn>
- **Version:** 0.81.0
- **Source summary:** Organization lookup and server tool (ASN / IPv4 / IPv6 / Prefix / AS Path)
- **Homepage:** <https://github.com/nitefood/asn>
- **Repository:** <https://github.com/nitefood/asn>
- **Upstream docs:** <https://github.com/nitefood/asn#readme>
- **License:** MIT
- **Source archive:** <https://github.com/nitefood/asn/archive/refs/tags/v0.81.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- asn (cli)
- asn (alias)

## Dependencies

- aha
- bash
- coreutils
- grepcidr
- ipcalc
- mtr
- nmap

## Uses from macOS

- jq
- whois

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.81.0
- Local data: ok
- Upstream repository: https://github.com/nitefood/asn
- Upstream latest detected: v0.81.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

asn is a Bash-based network lookup, recon, and traceroute server tool centered on autonomous systems, prefixes, RPKI validity, BGP statistics, geolocation, reputation, and IP/ASN investigation workflows.

### Project history

The nitefood/asn repository was created in July 2020. The README describes a single command-line tool that can also run as a web traceroute server and as a JSON-producing lookup API endpoint.

The project grew beyond simple ASN lookup into a collector of network intelligence APIs and command-line workflows. Its README lists Team Cymru, Prefix Whois, PeeringDB, CAIDA ASRank, RIPEStat, RIPE IPmap, Shodan, Cloudflare Radar, GreyNoise, NVD, IPQualityScore, ipinfo.io, and other data providers as supported inputs.

### Adoption history

asn has unusually broad packaging for a shell network tool. The README displays OS support for Debian, Ubuntu, Kali, CentOS, Red Hat, Rocky Linux, Fedora, Arch, Manjaro, Alpine, openSUSE, FreeBSD, Nix, macOS, Windows environments, and Raspberry Pi, and the input package facts list apk, Homebrew, Debian, Nix, and Ubuntu packages.

GitHub metadata shows roughly two thousand stars and active releases through 2026. Homebrew analytics show continuing installs, while the README's Repology badge points at multi-repository packaging status.

### How it is used

The common workflow is to run `asn` against an IP address, hostname, prefix, AS number, URL, or organization name and inspect enriched network output. The tool can do AS path tracing with mtr, RPKI checks, organization searches, Shodan recon, country CIDR mapping, bulk geolocation, and JSON output for pipelines.

Configuration is deliberately Unix-like: defaults can be overridden with `$HOME/.asnrc`, and optional API tokens are read from `$HOME/.asn/` for user mode or `/etc/asn/` for server mode. Docker and Google Cloud Shell workflows are documented for users who do not want a local install.

### Why package nerds care

asn is significant because it packages a messy incident-response habit, asking several network-intelligence services about an address or ASN, into a scriptable CLI. For package maintainers, it is also an instructive case: a Bash tool with many external command and API integrations, distro packages, container usage, and optional credential files.

It occupies the same practical shelf as whois, dig, mtr, bgp.tools shortcuts, and OSINT helper scripts, but makes the package-manager version matter because release updates can add or repair upstream data-provider integrations.

### Timeline

- 2020: GitHub repository created.
- 2024: v0.76 and v0.78 releases published.
- 2025: v0.79 and v0.80 releases published.
- 2026: v0.81.0 published and listed by Homebrew as the stable version.

### Related projects

- The README documents integrations with mtr, Team Cymru IP to ASN mapping, Prefix Whois, PeeringDB, CAIDA ASRank, RIPEStat, Cloudflare Radar, Shodan, GreyNoise, ipinfo.io, and other network-data services.

### Sources

- <https://api.github.com/repos/nitefood/asn>
- <https://api.github.com/repos/nitefood/asn/releases>
- <https://formulae.brew.sh/api/formula/asn.json>
- <https://github.com/nitefood/asn#readme>
- source_facts.package-manager


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool 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

- Unix: ~/.asnrc

## Credential files

- Unix: ~/.asn/ipinfo_token, /etc/asn/ipinfo_token, ~/.asn/iqs_token, /etc/asn/iqs_token, ~/.asn/cloudflare_token, /etc/asn/cloudflare_token
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** asn
- **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

- Debian apt - asn - 0.78.0-1: normalized package name match | Debian stable package indexes: asn from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | network OSINT CLI ASN, RPKI, BGP, Geo, Recon, Trace | https://github.com/nitefood/asn/
- Nix - asn: normalized package name match | nixpkgs package indexes: pkgs/by-name/as/asn/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - asn - 0.75.3-1.1: normalized package name match | Ubuntu 24.04 LTS package indexes: asn from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | network OSINT CLI ASN, RPKI, BGP, Geo, Recon, Trace | https://github.com/nitefood/asn/
- apk - asn - 0.81.0-r0: normalized package name match | Alpine Linux edge package indexes: asn from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | ASN Lookup Tool and Traceroute Server | https://github.com/nitefood/asn/


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [aha](https://www.automicvault.com/pkg/brew/aha/) - Runtime dependency declared by Homebrew.
- [bash](https://www.automicvault.com/pkg/brew/bash/) - Runtime dependency declared by Homebrew.
- [coreutils](https://www.automicvault.com/pkg/brew/coreutils/) - Runtime dependency declared by Homebrew.
- [grepcidr](https://www.automicvault.com/pkg/brew/grepcidr/) - Runtime dependency declared by Homebrew.
- [ipcalc](https://www.automicvault.com/pkg/brew/ipcalc/) - Runtime dependency declared by Homebrew.
- [mtr](https://www.automicvault.com/pkg/brew/mtr/) - Runtime dependency declared by Homebrew.
- [nmap](https://www.automicvault.com/pkg/brew/nmap/) - Runtime dependency declared by Homebrew.
- [asnmap](https://www.automicvault.com/pkg/brew/asnmap/) - Shares av.db curated category or tags: asn, cli, network, networking.
- [arping](https://www.automicvault.com/pkg/brew/arping/) - Shares av.db curated category or tags: cli, network, networking.
- [asroute](https://www.automicvault.com/pkg/brew/asroute/) - Shares av.db curated category or tags: cli, network, networking.
- [geoip2fast](https://www.automicvault.com/pkg/brew/geoip2fast/) - Shares av.db curated category or tags: asn, cli, networking.
- [activemq](https://www.automicvault.com/pkg/brew/activemq/) - Shares av.db curated category or tags: cli, networking.
- [adns](https://www.automicvault.com/pkg/brew/adns/) - Shares av.db curated category or tags: cli, networking.
- [aerleon](https://www.automicvault.com/pkg/brew/aerleon/) - Shares av.db curated category or tags: cli, networking.
- [ahcpd](https://www.automicvault.com/pkg/brew/ahcpd/) - Shares av.db curated category or tags: cli, networking.
- [plowshare](https://www.automicvault.com/pkg/brew/plowshare/) - Local package facts share a topical domain. Shared terms: bash, cli, coreutils, networking.

## Combined YAML source

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