Install AdGuardian Term on Linux, macOS, and Windows

AdGuardian Term can be installed in six ways. Docker is the quickest path if you already have Docker — no Rust toolchain needed and the image is only 12 MB. Pre-built binaries are the best choice for machines without Docker or Rust, since the executable has zero runtime dependencies. Cargo (cargo install adguardian) is ideal if you already have the Rust toolchain. Scoop covers Windows users who prefer a package manager. The AUR package targets Arch Linux. Finally, the one-liner quick-start script auto-detects your OS and architecture, downloads the right binary, and launches it — perfect for a fast first run on any Unix-like system.

Not sure which method to choose?

Docker is the easiest but requires the Docker daemon and adds a small layer of overhead (the image is 12 MB).
Pre-built binary has no dependencies at all — download, chmod +x, and run.
Cargo is straightforward if you already have Rust installed, and keeps the binary in your ~/.cargo/bin PATH automatically.
Build from source is required if your system architecture isn’t listed below, or if you want to run a fork or apply local modifications.

Installation Methods

Pull and run the latest image from Docker Hub with a single command:

docker run -it lissy93/adguardian

If you encounter issues with Docker Hub, or prefer a different registry, the same image is published to the GitHub Container Registry:

docker run -it ghcr.io/lissy93/adguardian

To build the image yourself from source (for example, to apply local changes or pin a specific commit):

docker buildx build -t adguardian .
docker run -it adguardian

To pass your AdGuard Home credentials at runtime, use -e flags — see the Quickstart for a full example with all environment variables.

If you have Rust and Cargo installed, pull AdGuardian Term directly from crates.io:

cargo install adguardian

Once installed, the adguardian binary is placed in ~/.cargo/bin (which should already be on your PATH). Launch it with:

adguardian

If you don’t yet have Rust, install it via rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Pre-built binaries for each supported platform are published to GitHub Releases. Download the binary for your system, make it executable, and run it:

curl -L -o adguardian https://github.com/Lissy93/AdGuardian-Term/releases/latest/download/adguardian-linux && \
chmod +x adguardian && \
./adguardian

Replace the filename at the end of the URL with the target that matches your platform:

Platform	Binary filename
Linux x86_64	`adguardian-linux`
Linux ARM64	`adguardian-linux-arm64`
Linux ARMv7	`adguardian-linux-armv7`
macOS ARM64 (Apple Silicon)	`adguardian-macos`
macOS x86_64 (Intel)	`adguardian-macos-x86_64`
Windows	`adguardian-windows.exe`

All binaries are available at: https://github.com/Lissy93/AdGuardian-Term/releases/latest/download/<binary-filename>Alternatively, visit the Releases page to browse all versions and download manually.

On Windows, AdGuardian Term is available through the Scoop package manager via the extras bucket:

scoop install extras/adguardian

If you haven’t added the extras bucket yet, Scoop will prompt you to do so, or you can add it manually first:

scoop bucket add extras
scoop install adguardian

This was contributed by @kzshantonu in ScoopInstaller/Extras#11386.

On Arch Linux, AdGuardian Term is available from the Arch User Repository. Install it with your preferred AUR helper:

# Using paru
paru -Syu adguardian

# Using yay
yay -Syu adguardian

Or clone and build manually with makepkg:

git clone https://aur.archlinux.org/adguardian.git
cd adguardian
makepkg -si

The quick-start script detects your operating system and CPU architecture, downloads the appropriate binary from GitHub Releases, marks it executable, and runs it — all in one step:

bash <(curl -sL https://raw.githubusercontent.com/Lissy93/AdGuardian-Term/main/quick-start.sh)

The script supports Linux (x86_64, ARM64, ARMv7), macOS (ARM64, x86_64), and Windows (via Cygwin). If your architecture is not supported, it will print an error and direct you to the documentation for alternative installation methods.

Review the quick-start.sh script before running it to understand exactly what it does. It uses curl or wget (whichever is available) to download the binary to ./adguardian in your current directory.

Get Started

Configuration

Deployment

Development

Install AdGuardian Term on Linux, macOS, and Windows

Installation Methods

Build docs developers (and LLMs) love

Get Started

Configuration

Deployment

Development

Documentation Index

​Installation Methods

Build docs developers (and LLMs) love

Installation Methods