Repository files navigation

Improve your security and privacy by blocking ads, tracking and malware domains.

hBlock is a POSIX-compliant shell script that gets a list of domains that serve ads, tracking scripts and malware frommultiple sourcesand creates ahosts file,among other formats, that prevents your systemfrom connecting to them.

⚠️ hBlock by defaultreplaces the hosts file of your system, consider making a backup first if you have entries you want to preserve.

hBlock is available in various package managers. Please check thePACKAGES.md file for an up-to-date list.

The latest available version can also be installed manually by running the following commands:

curl -o /tmp/hblock'https://raw.githubusercontent.com/hectorm/hblock/v3.5.1/hblock' \&&echo'd010cb9e0f3c644e9df3bfb387f42f7dbbffbbd481fb50c32683bbe71f994451  /tmp/hblock'| shasum -c \&& sudo mv /tmp/hblock /usr/local/bin/hblock \&& sudo chown 0:0 /usr/local/bin/hblock \&& sudo chmod 755 /usr/local/bin/hblock

Additionally, asystemd timer can be set to regularly update the hosts file for new additions.

The default behavior of hBlock can be adjusted with multiple options. Use the--help option or check thehblock.1.md file for thefull list.

Nightly builds of the hosts file, among other formats, can be foundon the hBlock website.

Sometimes you may need to temporarily disable hBlock, a quick option is to generate a hosts file without any blocked domains by running the followingcommand:

hblock -S none -D none

It's possible that sometimes one of the hBlock sources includes a domain that shouldn't be blocked, in those cases the best way to proceed is totemporarily add said domain to the allowlist and report the problem to the original blocklist author. This way it will also be automaticallyremoved from hBlock within 24h.

To find which blocklist is behind a false positive you can clone thehMirror project and search for that domain.Although please note that not all hMirror blocklists are used by default in hBlock, an updated list of the sources used can be found in theSOURCES.md file.