install

Additional install commands

macOS

Homebrewverified · 100%

brew install onionprobe

local Homebrew formula metadata

Linux

Debian aptverified · 92%

sudo apt install onionprobe

Debian stable package indexes · onionprobe · source: deb.debian.org

Nixverified · 92%

nix profile install nixpkgs#onionprobe

nixpkgs package indexes · pkgs/by-name/on/onionprobe/package.nix · source: api.github.com

overview

Package summary

Test and monitoring tool for Tor Onion Services

Project links

Commands and aliases

onionprobe

history

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 posture

No protected-tool coverage found yet

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.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 5 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

Command	Kind	Exposure	Note
`onionprobe`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version1.4.1

manager updated2026-05-14

local dataok

upstreamnot checked

latest detectednot detected

https://tpo.pages.torproject.net/onion-services/onionprobe/

infoRelease/tag comparison is only available for GitHub repositories.https://tpo.pages.torproject.net/onion-services/onionprobe/none confidence

install metadata

Package metadata

Package key	brew:onionprobe
Version	1.4.1
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/onionprobe
Homepage	https://tpo.pages.torproject.net/onion-services/onionprobe/
Repository	https://gitlab.torproject.org/tpo/onion-services/onionprobe
Upstream docs	https://tpo.pages.torproject.net/onion-services/onionprobe
License	GPL-3.0-or-later
Source archive	https://files.pythonhosted.org/packages/30/d0/6441b228ce174481ace50dec6a19ce6298eebdb35d06f40f7b1de66f51c4/onionprobe-1.4.1.tar.gz
Last updated	2026-05-14T09:54:07Z
Pulse	updated
Dependencies	certifi, cryptography, libyaml, python@3.14, tor
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

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	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

onionprobe 1.4.0+ds-1

test/monitor tool for Tor Onion Services sites

https://gitlab.torproject.org/tpo/onion-services/onionprobe

sudo apt install onionprobe

Section: net
Architecture: all
10 dependencies
1 optional deps
normalized package name match
Matched by: Onionprobe

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

Nix95%

onionprobe

nix profile install nixpkgs#onionprobe

normalized package name match
Matched by: Onionprobe

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

Ubuntu apt95%

onionprobe 1.1.2+ds-1

test/monitor tool for Tor Onion Services sites

https://gitlab.torproject.org/tpo/onion-services/onionprobe

sudo apt install onionprobe

Section: universe/net
Architecture: all
10 dependencies
1 optional deps
normalized package name match
Matched by: Onionprobe

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

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/onionprobe.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install onionprobe with Homebrew, apt, Nix