Installation

Like any proxy software, Hysteria consists of a server and a client. Our precompiled executables includes both modes on all platforms. You can download our latest releases using one of the following options:

• Executable files
• GitHub Releases
• Deployment script for Linux servers
• Arch Linux AUR
• Docker images
• Use 3rd-party apps
• Build from source

Executable files

Click on the filename to download. All files are the latest version.

Windows macOS Linux Android FreeBSD

File	Arch	Note
hysteria-windows-amd64.exe	x86-64
hysteria-windows-amd64-avx.exe	x86-64	Requires AVX
hysteria-windows-386.exe	x86
hysteria-windows-arm64.exe	ARM64

File	Arch	Note
hysteria-darwin-amd64	x86-64
hysteria-darwin-amd64-avx	x86-64	Requires AVX
hysteria-darwin-arm64	ARM64	M1 or newer

File	Arch	Note
hysteria-linux-amd64	x86-64
hysteria-linux-amd64-avx	x86-64	Requires AVX
hysteria-linux-386	x86
hysteria-linux-arm	ARMv7
hysteria-linux-armv5	ARMv5
hysteria-linux-arm64	ARM64
hysteria-linux-s390x	s390x
hysteria-linux-mipsle	MIPS	Little Endian
hysteria-linux-mipsle-sf	MIPS	Little Endian, Soft Float
hysteria-linux-riscv64	RISC-V 64

Note: These files are not Android app (APK) but Linux ELF executables built with NDK. If you don't know how to use them, please use 3rd-party apps instead.

File	Arch	Note
hysteria-android-amd64	x86-64
hysteria-android-386	x86
hysteria-android-armv7	ARMv7
hysteria-android-arm64	ARM64

File	Arch	Note
hysteria-freebsd-amd64	x86-64
hysteria-freebsd-amd64-avx	x86-64	Requires AVX
hysteria-freebsd-386	x86
hysteria-freebsd-arm	ARMv7
hysteria-freebsd-arm64	ARM64

Deployment script for Linux servers

We provide a bash script that automatically downloads the latest version of Hysteria and configures a systemd service on common Linux distributions.

Install or update to the latest version:

bash <(curl -fsSL https://get.hy2.sh/)

Install or update to a specific version (skips version check):

bash <(curl -fsSL https://get.hy2.sh/) --version v2.4.2

Remove Hysteria:

bash <(curl -fsSL https://get.hy2.sh/) --remove

Docker images

Docker Hub: https://hub.docker.com/r/tobyxdd/hysteria

Compose example

version: "3.9"
services:
  hysteria:
    image: tobyxdd/hysteria
    container_name: hysteria
    restart: always
    network_mode: "host"
    volumes:
      - acme:/acme
      - ./hysteria.yaml:/etc/hysteria.yaml
    command: ["server", "-c", "/etc/hysteria.yaml"]
volumes:
  acme: