# Install hysteria with Homebrew, MacPorts, Nix, scoop, winget Feature-packed proxy & relay tool optimized for lossy, unstable connections. Version 2.11.0 via Homebrew; verified 2026-08-01. Also installable with nix: nix profile install nixpkgs#hysteria. ## 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 - **Version:** 2.11.0 - **Source summary:** Feature-packed proxy & relay tool optimized for lossy, unstable connections - **Homepage:** - **Repository:** - **Last updated:** 2026-08-01T04:52:44Z - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - hysteria (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 2.11.0 ## 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 ## 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 ## Combined YAML source View the package source record on GitHub. [combined/hysteria.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hysteria.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph