Ads and trackers can follow you. In most cases, advertising may not be appropriate. Thanks to trackers, your personal information will be used to determine the effective way to sell any product to you. Both banner ads and trackers slow down your browser and interfere with and degrade your browsing experience.

    AdGuard Home is a software that keeps your network secure and blocks ads and trackers. In this article, we will look at how to install it in a Docker container using docker-compose as well.

    Let's install Docker.

    Update OS packages.

    apt update

    Install the necessary packages and add a new repository:




    apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
    curl -fsSL | sudo apt key add -
    add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable"


    Update the packages with the new repository:





    apt update


    Now let's install Docker.





    apt-get install docker-ce docker-ce-cli


    Let's check the version:





    docker --version


    Let's check the status:





    systemctl status docker


    If it does not start, then run:





    systemctl start docker


    And add to autorun.





    systemctl enable docker




    Install Docker Compose

    For this project, version 1.25 will be enough for us.





    curl -L "$(uname -s)-$(uname -m)" -o /usr/local/bin /docker-compose


    Set permissions to launch.





    chmod +x /usr/local/bin/docker-compose


    Check how Docker-Compose was installed:





    docker-compose --version


    Add a Linux user to the docker group:





    usermod -aG docker $USER


    Let's create a *.yaml file for Docker-Compose.

    To navigate in the future in what we have installed, let's create a separate folder for this project in the /home directory and go to it.





    mkdir /home/adguardhome && cd /home/adguardhome


    You can also use a different directory to host this and other projects.

    Let's use the repository to create the docker-compose.yaml file at

    Create a docker-compose.yaml or docker-compose.yml file,





    vim docker-compose.yaml


    And add the following code to it:





    version: '3.3'
            image: adguard/adguardhome
            container_name: adguardhome
                - /opt/adguardhome/work:/opt/adguardhome/work
                - /opt/adguardhome/conf:/opt/adguardhome/conf
                - 53:53/tcp
                - 53:53/udp
                - 67:67/udp
                - 68:68/udp
                - 80:80/tcp
                - 443:443/tcp
                - 443:443/udp
                - 3000:3000/tcp
                - 853:853/tcp
                - 784:784/udp
                - 853:853/udp
                - 8853:8853/udp
                - 5443:5443/tcp
                - 5443:5443/udp
            restart: always



    container_name: name of your container;
    In the volumes block, specify the paths along which the configuration files will be available;
    The ports block specifies the ports that need to be passed into the container.

    Run the script (for this you need to be in the directory where our file was created. In this case, it is /home/adguardhome/):





    docker-compose up -d


    We are waiting for the download of images, and deployment.

    We check:





    docker-compose ps







    docker ps


    You can also install adguardhome with one command without using docker compose.





    docker run --name adguardhome\\
         --restart unless-stopped\\
         -v /my/own/workdir:/opt/adguardhome/work\\
         -v /my/own/confdir:/opt/adguardhome/conf\\
         -p 53:53/tcp -p 53:53/udp\\
         -p 67:67/udp -p 68:68/udp\\
         -p 80:80/tcp -p 443:443/tcp -p 443:443/udp -p 3000:3000/tcp\\
         -p 853:853/tcp\\
         -p 784:784/udp -p 853:853/udp -p 8853:8853/udp\\
         -p 5443:5443/tcp -p 5443:5443/udp\\
         -d adguard/adguardhome


    Now, in order to enter the administration panel, you need to disable the DNSStubListener on the server. To do this, create a directory and a new file:





    mkdir -p /etc/systemd/resolved.conf.d
    vim /etc/systemd/resolved.conf.d/adguardhome.conf


    And add the following code to it:







    To enable resolve.conf, run the following commands:





    mv /etc/resolv.conf /etc/resolv.conf.backup
    ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf


    Update DNSStubListener:





    systemctl reload-or-restart systemd-resolved


    Now we can use our IP to connect to adguardhome and install. After that, you can connect with the data that you entered during installation.

    Approximately such a picture will be observed in your personal account.

    In order for adguardhome to start blocking ads, enter the IP of the server hosting adguardhome in the DNS field. This can be done both in the router and in a personal PC.

    Enjoy surfing without trackers and ads.