Pi-hole Ubuntu Deploy provides automated tooling to turn any Ubuntu Server, virtual machine, or spare PC into a network-wide DNS-based ad blocker. Choose between a single Bash script for direct bare-metal installs or an Ansible + Docker Compose playbook for containerised deployments — both paths handle port conflicts, firewall rules, and initial Pi-hole configuration for you.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/damianiglesias/pihole-ubuntu-deploy/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Deploy Pi-hole on Ubuntu in under 10 minutes with the automated installer.
Prerequisites
Hardware, OS, and network requirements before you begin.
Bash Script
Install Pi-hole directly on the OS — best for dedicated hardware.
Ansible + Docker
Deploy with Docker Compose via Ansible — best for VMs and repeatable setups.
What gets installed
Pi-hole Ubuntu Deploy walks you through each component interactively, so you only install what you need.Pi-hole v6
DNS sinkhole that blocks ads and telemetry for every device on your network.
Unbound
Recursive DNS resolver that removes reliance on upstream providers like Google or Cloudflare.
PADD Dashboard
Terminal dashboard displaying live Pi-hole stats — optionally auto-started on SSH login.
DNS Manager
Python tool for managing Pi-hole local DNS records from a plain-text entries file.
How it works
Choose a deployment method
Run the Bash script for a direct install, or use the Ansible playbook for a Docker-based deployment.
Follow the interactive prompts
The installer guides you through optional components — Unbound, PADD, DNS Manager, Log2Ram, and static IP configuration.
Unbound recursive DNS is included in the installer but is currently experimental. See the Unbound page for configuration details and known limitations.