# Install tuntox with Homebrew, Nix, pacman Tunnel TCP connections over the Tox protocol. Version 0.0.10.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:tuntox ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install tuntox ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#tuntox ``` Evidence: nixpkgs package indexes: pkgs/by-name/tu/tuntox/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S tuntox ``` Evidence: Arch Linux sync databases: tuntox from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ## Package facts - **Package key:** brew:tuntox - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.0.10.1 - **Source summary:** Tunnel TCP connections over the Tox protocol - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-only - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - tuntox (cli) - tuntox (alias) ## Dependencies - toxcore ## Build dependencies - cscope - pkgconf ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.0.10.1 - Local data: ok - Upstream repository: https://github.com/gjedeer/tuntox - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage tuntox is a small command-line networking tool for forwarding TCP connections over the Tox peer-to-peer protocol, aimed at reaching machines behind NAT or dynamic addresses without router port forwarding. ### Project history The project appeared publicly in December 2014 in the official GitHub repository. Its README framed it as early work in progress and described a single binary that can run in either server or client mode, with the server publishing a Tox ID and the client forwarding local ports to services behind that Tox identity. The early releases developed the core tunneling workflow and added shared-secret authentication by version 0.0.4. Later official releases continued into 2021, while the README and FAQ kept the focus on practical NAT traversal, SSH-style local forwarding, and operational cautions around Tox connectivity and security. ### Adoption history tuntox stayed niche but was packaged beyond Homebrew. The supplied package metadata lists Homebrew, Nix, and Arch pacman entries, and the official FAQ lists additional distribution packaging such as Arch, Homebrew, NixOS, Pentoo, Void, and work-in-progress Debian packaging. ### How it is used A typical use is to run `tuntox` on a remote laptop, home machine, or Raspberry Pi behind NAT, save its Tox identity under `/etc/tuntox/` or a `-C` directory, and connect from another machine with an SSH-like `-L` forwarding rule. Package-manager users mostly encounter it as a tiny tunnel binary: install it, run the server without root, then use local port forwarding or SSH `ProxyCommand` mode to reach a private service over the Tox overlay. ### Why package nerds care For package nerds, tuntox is interesting less as a mainstream remote-access product and more as a packaged example of the Tox ecosystem being used as infrastructure: a peer-to-peer overlay repurposed for TCP forwarding, NAT traversal, and occasional Tor/proxy-aware experiments. ### Timeline - 2014: GitHub repository created and 0.0.1 initial release published. - 2015: 0.0.4 release introduced the shared-secret security mode documented in the README. - 2018: FAQ documented relay-versus-UDP behavior and distro packaging status. - 2021: 0.0.10 release published. ### Related projects - Tox - c-toxcore - uTox - OpenSSH local port forwarding ### Sources - GitHub API for gjedeer/tuntox: repository created 2014-12-11 and releases 0.0.1 through 0.0.10. - - - source_facts.package-manager: Homebrew, Nix, and pacman package-manager presence. ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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. ## Credential files - Unix: /etc/tuntox/, directory passed with -C ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** tuntox - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - tuntox: normalized package name match | nixpkgs package indexes: pkgs/by-name/tu/tuntox/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - tuntox - 0.0.10.1-2: normalized package name match | Arch Linux sync databases: tuntox from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Tunnel TCP connections over the Tox protocol | https://github.com/gjedeer/tuntox ## 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. - [toxcore](https://www.automicvault.com/pkg/brew/toxcore/) - Runtime dependency declared by Homebrew. - [cscope](https://www.automicvault.com/pkg/brew/cscope/) - Build dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [openiothub-server](https://www.automicvault.com/pkg/brew/openiothub-server/) - Shares av.db curated category or tags: cli, nat-traversal, networking, tunneling. - [jprq](https://www.automicvault.com/pkg/brew/jprq/) - Shares av.db curated category or tags: cli, networking, tunneling. - [localtunnel](https://www.automicvault.com/pkg/brew/localtunnel/) - Shares av.db curated category or tags: cli, networking, tunneling. - [pgrok](https://www.automicvault.com/pkg/brew/pgrok/) - Shares av.db curated category or tags: cli, networking, tunneling. - [ptunnel](https://www.automicvault.com/pkg/brew/ptunnel/) - Shares av.db curated category or tags: cli, networking, tunneling. - [tcptunnel](https://www.automicvault.com/pkg/brew/tcptunnel/) - Shares av.db curated category or tags: cli, networking, tunneling. - [udptunnel](https://www.automicvault.com/pkg/brew/udptunnel/) - Shares av.db curated category or tags: cli, networking, tunneling. - [wstunnel](https://www.automicvault.com/pkg/brew/wstunnel/) - Shares av.db curated category or tags: cli, networking, tunneling. - [bore-cli](https://www.automicvault.com/pkg/brew/bore-cli/) - Local package facts share a topical domain. Shared terms: cli, forwarding, networking, tcp, tunnel. - [dns2tcp](https://www.automicvault.com/pkg/brew/dns2tcp/) - Local package facts share a topical domain. Shared terms: cli, networking, over, tcp, tunnel. ## Combined YAML source View the package source record on GitHub. [combined/tuntox.yml](https://github.com/automic-vault/db/blob/main/combined/tuntox.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