From Amahi Wiki
Jump to: navigation, search

This section will document how to run your HDA as a network wide ad-blocking tool, utilising DNS redirects and a small pixel server.

The work here was based on:

Pixelserv is a webserver which simply serves 1x1 blank pixels. By redirecting web requests for adverts to our pixelserver, ads are replaced by this 1x1 pixel leaving the target webpage intact. This will work on all devices across your network, removing the need for software-based solutions on each device.

A shell script will update the list of blocked domains (stored as /etc/dnsmasq.adblock.conf) whever you run it. You can also manually edit the list and remove domains that you wish to see (in the case of wrongly blocked domains).

Fedora 19 or Greater

Precusors -

  • You'll need net-tools installed to use ifconfig
yum install net-tools
  • You also need a file editing tool. Vi will suffice, however nano is a bit more user friendly.
yum install nano
  • This guide assumes your network interface is named p2p1 and your HDA IP address is Check with ifconfig, and change this guide where neccessary.

Get Ad List

This part of the process creates a file on your HDA which identifies where adverts originate from, and where to redirect them to.

  • Create a new shell file
nano /usr/local/bin/
  • Copy and paste the following into it
# Download the DNSmasq formatted ad block list
curl "" | sed "s/127\.0\.0\.1/" > /etc/dnsmasq.adblock.conf
# Restart DNSmasq
service dnsmasq restart
  • Change permissions on the shell file
chmod -v 755 /usr/local/bin/
  • Run the shell file

Change DNSMasq config

DNSMasq reads the adlist file and redirects DNS requests as configured.

  • Add the block list to DNSMasq configuration
echo "conf-file=/etc/dnsmasq.adblock.conf" >> /etc/dnsmasq.conf
  • Restart DNSMasq
service dnsmasq restart

Bind Apache to main IP address

By default, Apache will try to use all IP addresses. We require an IP address later in the process and so we have to tell Apache only to use the standard HDA address.

  • Edit the Apache config file using a file editor:
nano /etc/httpd/conf/httpd.conf
  • Add your HDAs IP address to this section in the conf file:
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the <VirtualHost>
# directive.
# Change this to Listen on specific IP addresses as shown below to
# prevent Apache from glomming onto all bound IP addresses.
  • Restart Apache
service httpd restart

Pixel Server

The pixel server is where we're redirecting adverts to. A simple 1x1 pixel is served on the IP address specified.

  • You need to download Pixelserv to the HDA:
  • Move and rename the Pixelserv binary:
mv /usr/local/bin/pixelserv
  • Edit pixelserv using a file editing program of your choice
nano /usr/local/bin/pixelserv
  • Change the IP address to a free one of your choice (eg.
$sock = new IO::Socket::INET (  LocalHost => '',

change to

$sock = new IO::Socket::INET (  LocalHost => '',
  • Change permissions
chmod 755 /usr/local/bin/pixelserv 

  • Create file /etc/init.d/pixelserv
nano /etc/init.d/pixelserv

and copy the following to it (changing the IP addresses and interfaces where neccessary):

#! /bin/sh
# /etc/init.d/pixelserv

# Carry out specific functions when asked to by the system
case "$1" in
     echo "Creating Interface "
     ifconfig p2p1:0
     echo "Starting pixelserv "
     /usr/local/bin/pixelserv &
     echo "Stopping script pixelserv"
     pkill -9 pixelserv &
     echo "Killing Interface "
     ifconfig p2p1:0 down
     echo "Usage: /etc/init.d/pixelserv {start|stop}"
     exit 1
exit 0
  • Change permissions
chmod 755 /etc/init.d/pixelserv
  • To bring the new interface up and start pixelserv
/etc/init.d/pixelserv start
  • To stop pixelserv and close the virtual interface
/etc/init.d/pixelserv stop

To keep the list updated weekly, do the following:

ln -s /usr/local/bin/ /etc/cron.daily/get-ad-block-list

Enjoy ad-free network on ALL devices!