# Install hysteria with Homebrew, MacPorts, Nix, scoop, winget Feature-packed proxy & relay tool optimized for lossy, unstable connections. Version 2.9.3 via Homebrew; verified 2026-06-27. ## Install ```sh sudo av install brew:hysteria ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hysteria ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install hysteria ``` Evidence: MacPorts ports tree: net/hysteria/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#hysteria ``` Evidence: nixpkgs package indexes: pkgs/by-name/hy/hysteria/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install extras/hysteria ``` Evidence: Scoop official bucket manifest trees: bucket/hysteria.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id apernet.Hysteria -e ``` Evidence: Windows Package Manager source index: apernet.Hysteria from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:hysteria - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.9.3 - **Source summary:** Feature-packed proxy & relay tool optimized for lossy, unstable connections - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-27T09:33:07Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - hysteria (cli) - hysteria (alias) ## Build dependencies - go ## 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: 2.9.3 - Package-manager updated: 2026-06-27 - Local data: ok - Upstream repository: https://github.com/apernet/hysteria - Upstream latest detected: app/v2.9.3 (current) ## Project history and usage Hysteria is a proxy and relay tool built around a customized QUIC protocol, designed for high performance on unreliable or lossy networks and for traffic that can masquerade as HTTP/3. ### Project history The GitHub release history begins in 2020 with the original v0.x line. The README presents Hysteria as a fast, censorship-resistant proxy with SOCKS5, HTTP proxy, TCP and UDP forwarding, Linux TProxy, TUN mode, custom authentication, traffic statistics, and access control. Hysteria 2 arrived as `app/v2.0.0` in September 2023. The protocol documentation describes the v2 protocol as a TCP and UDP proxy based on QUIC for speed, security, and censorship resistance; release notes after v2 added masquerade servers, Android builds, congestion-control work, port hopping, ACME improvements, sharing links, mTLS, and Realms NAT traversal. ### Adoption history Hysteria is packaged by Homebrew and appears in MacPorts, Nix, Scoop, and winget metadata. Its docs also provide a Linux deployment script, Docker images, and cross-platform release binaries, which made it attractive to self-hosters and network operators working across desktop, server, and mobile environments. ### How it is used Operators configure a server and client with YAML files, commonly named `config.yaml`, and choose modes such as SOCKS5, HTTP proxy, TCP/UDP forwarding, TProxy, or TUN. Hysteria's appeal is strongest where packet loss, mobile links, congested Wi-Fi, long-distance routes, or censorship make ordinary proxy transports perform poorly. ### Why package nerds care Hysteria is notable because it packages modern transport ideas into a single deployable CLI: QUIC, HTTP/3 masquerading, congestion control tuning, port hopping, ACME, QR/share links, Docker images, and platform-native package-manager entries. For networking package nerds, it is a concrete example of censorship-resistance tooling becoming a routine `brew install` artifact. ### Timeline - 2020: v0.0.1 appeared in GitHub release metadata. - 2023: app/v2.0.0 was published as the first Hysteria v2 release. - 2024: v2.5.0 added ACME DNS challenge support and protocol sniffing. - 2025: v2.6.x added sharing links, mTLS, and QUIC/TLS behavior changes. - 2026: v2.9.x introduced Hysteria Realms NAT traversal and additional obfuscation work. ### Related projects - Hysteria belongs near QUIC-based and censorship-resistance proxy tools such as TUIC, sing-box, Clash-compatible clients, and other HTTP/3 or UDP-focused relay systems. ### Sources - - - - - - ## 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: ./config.yaml - Windows: .\config.yaml ## Credential files - Unix: ./config.yaml - Windows: .\config.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hysteria - **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 - hysteria: normalized package name match | nixpkgs package indexes: pkgs/by-name/hy/hysteria/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - hysteria: normalized package name match | MacPorts ports tree: net/hysteria/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - extras/hysteria: normalized package name match | Scoop official bucket manifest trees: bucket/hysteria.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 - winget - apernet.Hysteria: normalized package name match | Windows Package Manager source index: apernet.Hysteria from https://cdn.winget.microsoft.com/cache/source.msix ## 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. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [brook](https://www.automicvault.com/pkg/brew/brook/) - Shares av.db curated category or tags: cli, networking, proxy. - [connect](https://www.automicvault.com/pkg/brew/connect/) - Shares av.db curated category or tags: cli, networking, proxy. - [dante](https://www.automicvault.com/pkg/brew/dante/) - Shares av.db curated category or tags: cli, networking, proxy. - [geph4](https://www.automicvault.com/pkg/brew/geph4/) - Shares av.db curated category or tags: cli, networking, proxy. - [ghostunnel](https://www.automicvault.com/pkg/brew/ghostunnel/) - Shares av.db curated category or tags: cli, networking, proxy. - [gost](https://www.automicvault.com/pkg/brew/gost/) - Shares av.db curated category or tags: cli, networking, proxy. - [libproxy](https://www.automicvault.com/pkg/brew/libproxy/) - Shares av.db curated category or tags: cli, networking, proxy. - [mihomo](https://www.automicvault.com/pkg/brew/mihomo/) - Shares av.db curated category or tags: cli, networking, proxy. - [cloudflare-quiche](https://www.automicvault.com/pkg/brew/cloudflare-quiche/) - Local package facts share a topical domain. Shared terms: cli, http3, networking, quic. ## Combined YAML source View the package source record on GitHub. [combined/hysteria.yml](https://github.com/automic-vault/db/blob/main/combined/hysteria.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