# Install onionprobe with Homebrew, apt, Nix Test and monitoring tool for Tor Onion Services. Version 1.4.1 via Homebrew; verified 2026-05-14. ## Install ```sh sudo av install brew:onionprobe ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install onionprobe ``` Evidence: local Homebrew formula metadata ### Linux - Debian apt (92%): ```sh sudo apt install onionprobe ``` Evidence: Debian stable package indexes: onionprobe from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#onionprobe ``` Evidence: nixpkgs package indexes: pkgs/by-name/on/onionprobe/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:onionprobe - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.4.1 - **Source summary:** Test and monitoring tool for Tor Onion Services - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Last updated:** 2026-05-14T09:54:07Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - onionprobe (cli) - onionprobe (alias) ## Dependencies - certifi - cryptography - libyaml - python@3.14 - tor ## Install behavior - Post-install hook: not defined - 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.4.1 - Package-manager updated: 2026-05-14 - Local data: ok - Upstream repository: https://tpo.pages.torproject.net/onion-services/onionprobe/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Onionprobe is a Tor Project tool for testing and monitoring Tor Onion Services. It probes configured onion-service endpoints once or continuously and can export metrics to Prometheus, with Grafana and Alertmanager support in its monitoring-node setup. ### Project history Onionprobe grew out of the operational need to monitor onion services as services, not just publish them. Its manual frames the tool as a way to test endpoints and paths, while the project site presents it as part of the Onion Services Ecosystem maintained around Tor onion-service operations. The changelog shows active release engineering around the monitoring stack. Version 1.1.0 and 1.1.1 landed in April 2023, and Tor Project Forum announced version 1.2.0 on April 24, 2024 with a required database migration for monitoring-node users. ### Adoption history Onionprobe is distributed through PyPI and documented in Debian and Ubuntu manpages, with Homebrew packaging it for macOS and Linux users. The Tor Project also maintains an Ansible role that can install Onionprobe from Git, PyPI, or distribution packages and configure either a single service or a standalone monitoring node. ### How it is used Operators use onionprobe to check whether onion-service URLs are reachable, whether specific paths respond, and whether the results should feed a metrics pipeline. In standalone mode, the project provides a containerized monitoring node with Prometheus, Alertmanager, Grafana, a persistent dataset, and an Onionprobe exporter. The tool is especially practical for onion-service fleets because reachability can fail at several layers: Tor client connectivity, onion-service descriptor publication, path construction, web-service health, or application routing. Onionprobe packages those checks into a repeatable CLI and monitoring target. ### Why package nerds care For package nerds, Onionprobe is a clean example of a niche network daemon graduating into familiar observability shapes: PyPI package, distro package, Homebrew formula, man page, Prometheus exporter, Grafana dashboard, and Ansible role. ### Timeline - 2023-04-03: Onionprobe v1.1.0 was released. - 2023-04-04: Onionprobe v1.1.1 followed with Grafana, Docker, image-versioning, and database-upgrade fixes. - 2024-04-24: Onionprobe v1.2.0 was announced by the Tor Project with monitoring-node database migration notes. - 2026: Debian, Ubuntu, PyPI, and Homebrew provide install surfaces for the Onionprobe CLI. ### Related projects - Related projects and technologies include Tor onion services, Prometheus, Grafana, Alertmanager, the Onionprobe Ansible role, and Tor Project onion-service operational tooling. ### Sources - - - - - - - ## Security Notes No matching local secret-handling manifest was found for onionprobe. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** onionprobe - **Version Scheme:** 0 - **Revision:** 4 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - onionprobe - 1.4.0+ds-1: normalized package name match | Debian stable package indexes: onionprobe from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | test/monitor tool for Tor Onion Services sites | https://gitlab.torproject.org/tpo/onion-services/onionprobe - Nix - onionprobe: normalized package name match | nixpkgs package indexes: pkgs/by-name/on/onionprobe/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - onionprobe - 1.1.2+ds-1: normalized package name match | Ubuntu 24.04 LTS package indexes: onionprobe from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | test/monitor tool for Tor Onion Services sites | https://gitlab.torproject.org/tpo/onion-services/onionprobe ## Related links - [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. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [tor](https://www.automicvault.com/pkg/brew/tor/) - Runtime dependency declared by Homebrew. - [nyx](https://www.automicvault.com/pkg/brew/nyx/) - Shares av.db curated category or tags: cli, monitoring, networking, tor. - [cloudprober](https://www.automicvault.com/pkg/brew/cloudprober/) - Shares av.db curated category or tags: cli, monitoring, networking. - [darkstat](https://www.automicvault.com/pkg/brew/darkstat/) - Shares av.db curated category or tags: cli, monitoring, networking. - [dish](https://www.automicvault.com/pkg/brew/dish/) - Shares av.db curated category or tags: cli, monitoring, networking. - [dnstop](https://www.automicvault.com/pkg/brew/dnstop/) - Shares av.db curated category or tags: cli, monitoring, networking. - [easeprobe](https://www.automicvault.com/pkg/brew/easeprobe/) - Shares av.db curated category or tags: cli, monitoring, networking. - [httping](https://www.automicvault.com/pkg/brew/httping/) - Shares av.db curated category or tags: cli, monitoring, networking. - [httptap](https://www.automicvault.com/pkg/brew/httptap/) - Shares av.db curated category or tags: cli, monitoring, networking. - [onion-location](https://www.automicvault.com/pkg/brew/onion-location/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, networking, onion, onion-services, python. ## Combined YAML source View the package source record on GitHub. [combined/onionprobe.yml](https://github.com/automic-vault/db/blob/main/combined/onionprobe.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - 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