Setting up AdGuard Home with Docker Compose

AdGuard Home is a powerful, privacy-focused network-wide ad and tracker blocker that you can easily deploy on your own server. Using Docker Compose simplifies the setup and management process, allowing you to get AdGuard Home up and running in minutes. This guide will walk you through the entire process, from pulling the latest image to configuring port forwarding.

Why Use Docker Compose for AdGuard Home?

Docker Compose offers several advantages for running AdGuard Home:

Simplified Installation: No need to manually install dependencies or configure complex settings. Docker handles everything within a contained environment.
Easy Management: Starting, stopping, and updating AdGuard Home becomes a breeze with simple Docker Compose commands.
Portability: Your AdGuard Home configuration can be easily moved to another server by simply copying the docker-compose.yml file.
Resource Efficiency: Docker containers are lightweight and consume fewer resources compared to running AdGuard Home directly on the host operating system.

Creating Your Docker Compose File

The heart of your AdGuard Home deployment is the docker-compose.yml file. This file defines the services, networks, and volumes used by your application. Here’s a sample docker-compose.yml file to get you started:

version: "3.8"
services:
  adguardhome:
    image: adguard/adguardhome:latest
    ports:
      - "53:53/udp"
      - "53:53/tcp"
      - "8080:8080/tcp" # Admin interface
      - "3000:3000/tcp" # DNS-over-HTTPS
    volumes:
      - ./adguardhome_data:/opt/adguardhome/work
    restart: unless-stopped

This configuration exposes the necessary ports for DNS (53 UDP/TCP), the admin interface (8080), and DNS-over-HTTPS (3000). It also creates a persistent volume to store AdGuard Home’s data. You can modify these ports as needed.

Running AdGuard Home with Docker Compose

Once you’ve created your docker-compose.yml file, navigate to the directory containing the file in your terminal and run the following command:

docker-compose up -d

This command will download the AdGuard Home image, create the container, and start it in detached mode (running in the background).

You can now access the AdGuard Home admin interface by navigating to http://<your-server-ip>:8080 in your web browser.

Configuring AdGuard Home

After the initial setup, you’ll want to configure AdGuard Home to suit your needs. You can do this through the web interface, which you can access via port 8080.

Troubleshooting Common Issues

Sometimes, you might encounter issues during the setup process. Here are a few common problems and their solutions:

Port Conflicts: If another service is already using port 53, you’ll need to either stop that service or change the ports in your docker-compose.yml file.
Data Persistence Issues: Ensure that the volume mapping in your docker-compose.yml file is correct.
Networking Issues: Check your network configuration to ensure that Docker can access the internet.

adguard home docker-compose offers a convenient way to set up this powerful ad blocker.

Updating AdGuard Home with Docker Compose

Updating AdGuard Home is straightforward with Docker Compose. Simply run the following commands:

docker-compose pull
docker-compose up -d

This will pull the latest AdGuard Home image and restart the container with the updated version.

Conclusion

Using adguard home docker-compose provides a simple and efficient way to deploy and manage AdGuard Home. With its easy setup, portability, and resource efficiency, Docker Compose is the ideal solution for running AdGuard Home on your own server.

FAQ

What is AdGuard Home? AdGuard Home is a network-wide ad and tracker blocker.
Why use Docker Compose? It simplifies the installation and management of AdGuard Home.
How do I access the AdGuard Home interface? Navigate to http://<your-server-ip>:8080 in your browser.
How do I update AdGuard Home? Use docker-compose pull and docker-compose up -d.
What if I encounter port conflicts? Change the ports in your docker-compose.yml file or stop the conflicting service.
How do I ensure data persistence? Verify the volume mapping in your docker-compose.yml file.
Where can I find more information? Visit the official AdGuard Home documentation.