SIGN IN

    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 https://download.docker.com/linux/ubuntu/gpg | sudo apt key add -
    
    add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(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 containerd.io
    

     


    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 "https://github.com/docker/compose/releases/download/1.25.5/docker-compose-$(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 https://hub.docker.com/r/adguard/adguardhome

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

     

     

     

     

    vim docker-compose.yaml
    

     


    And add the following code to it:

     

     

     

     

    version: '3.3'
    services:
        adguardhome:
            image: adguard/adguardhome
            container_name: adguardhome
            volumes:
                - /opt/adguardhome/work:/opt/adguardhome/work
                - /opt/adguardhome/conf:/opt/adguardhome/conf
            ports:
                - 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

     



    Where:

    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
    

     


    Or:

     

     

     

     

    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:

     

     

     

     

    [Resolve]
    DNS=127.0.0.1
    DNSStubListener=no

     


    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.