mirror of https://github.com/YunoHost-Apps/adguardhome_ynh.git synced 2024-09-03 18:06:23 +02:00

AdGuard Home package for YunoHost: Network-wide ads & trackers blocking DNS server

Find a file

yunohost-bot 1a9c43b13e Auto-update READMEs		2024-05-12 03:35:54 +00:00
.github	v2	2023-04-06 09:27:41 +02:00
conf	Upgrade to v0.107.45 (#162 )	2024-03-06 22:32:18 +01:00
doc	normal link, not raw	2024-03-21 01:05:05 +01:00
scripts	Temporary fix for the API permission	2024-05-12 05:35:33 +02:00
ALL_README.md	Auto-update READMEs	2024-05-12 03:35:40 +00:00
check_process	Apply example_ynh	2022-07-29 21:30:38 +02:00
config_panel.toml	Merge branch 'testing' into version-2	2023-10-18 23:27:58 +02:00
LICENSE	update	2019-01-09 09:31:49 +01:00
manifest.toml	bump version	2024-05-12 05:35:49 +02:00
README.md	Auto-update READMEs	2024-05-12 03:35:54 +00:00
README_es.md	Auto-update READMEs	2024-05-12 03:35:54 +00:00
README_eu.md	Auto-update READMEs	2024-05-12 03:35:54 +00:00
README_fr.md	Auto-update READMEs	2024-05-12 03:35:54 +00:00
README_gl.md	Auto-update READMEs	2024-05-12 03:35:54 +00:00
README_zh_Hans.md	Auto-update READMEs	2024-05-12 03:35:54 +00:00
tests.toml	cleaning	2023-09-27 15:02:25 +02:00

README.md

AdGuard Home for YunoHost

Read this README in other languages.

This package allows you to install AdGuard Home quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

AdGuard Home is a network-wide software for blocking ads & tracking. After you set it up, it'll cover ALL your home devices, and you don't need any client-side software for that.

It operates as a DNS server that re-routes tracking domains to a "black hole", thus preventing your devices from connecting to those servers. It's based on software we use for our public AdGuard DNS servers -- both share a lot of common code.

Important note: This AdGuard Home package needs to disable Dnsmasq on the main network interface to allow AdGuard Home to listen DNS resquest using it.
However, Dnsmasq is not disabled and will continue to function as the localhost DNS server.

Shipped version: 0.107.48~ynh2

Screenshots

Documentation and resources

Official app website: https://adguard.com/adguard-home.html
Official user documentation: https://kb.adguard.com/en
Official admin documentation: https://github.com/AdguardTeam/AdGuardHome/wiki
Upstream app code repository: https://github.com/AdguardTeam/AdGuardHome
YunoHost Store: https://apps.yunohost.org/app/adguardhome
Report a bug: https://github.com/YunoHost-Apps/adguardhome_ynh/issues

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that:

sudo yunohost app install https://github.com/YunoHost-Apps/adguardhome_ynh/tree/testing --debug
or
sudo yunohost app upgrade adguardhome -u https://github.com/YunoHost-Apps/adguardhome_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps