🦊 Foxly AdGuard Updater

AdGuard Home Updater · Docs

Verified updates. Recoverable by design.

Install, configure, schedule, and recover safe AdGuard Home updates from one concise manual.

Open assistantGitHub ↗

01 · Overview

Controlled updates for your DNS service

The updater installs exact stable AdGuard Home releases on supported Linux systems.

Verified before changeChecksum, archive paths, binary version, and configuration are validated first.
Recovery includedVersioned backups and optional automatic rollback protect the running service.
IndependentCommunity project — not affiliated with or maintained by AdGuard.

02 · Requirements

Check the environment first

  • Linux with systemd on amd64 or arm64
  • Supported AdGuard Home installation under /opt/AdGuardHome
  • curl, tar, sha256sum, flock, systemctl, dig
  • Root access through sudo
Deployment typeContainer-based or package-managed installations are outside the supported update path.

03 · Installation

Ready in a few minutes

  1. 1
    Choose your settings

    Use the assistant to select update behavior, schedule, backups, and health checks.

  2. 2
    Review the command

    The generated command reflects every selected option and stays in your browser.

  3. 3
    Run the installer

    Paste the command into the target Linux system and follow its checks.

bash
curl -fsSL https://adguard.foxly.de/install.sh | sudo bash

Automatic updates remain disabled until explicitly enabled.

04 · Settings

Choose the update policy

Validated settings are stored in /etc/default/adguard-update.

TIMER_MODEDisable scheduled checks or enable a systemd timer.
AUTO_INSTALLReport available releases or install them automatically.
UPDATE_DELAY_DAYSWait before installing a new release.
BACKUP_RETENTIONKeep several versioned recovery points.
HEALTH_ROLLBACKRestore after failed service or DNS checks.

05 · Operations

Check, update, and inspect

bash
adguard-update --check
adguard-update --dry-run
sudo adguard-update
adguard-update --status
adguard-update --list-backups

Logs are written to /var/log/adguard-update.log and the systemd journal.

06 · Safeguards

Failure stops before damage

  • Release archive and checksum originate from the same official release
  • Archive paths, binary version, and configuration are validated
  • An exclusive lock prevents overlapping updater processes
  • Service startup and DNS resolution are checked after replacement
SHA-256The updater refuses downloads that do not match the official checksum.

07 · Recovery

Return to the last working version

bash
sudo adguard-update --rollback

Versioned backups are retained for recovery.

GitHub Issues ↗ · Full reference ↗