Pi-Hole Installation Manual for Linux

 Pi-Hole is a software tool that acts as a network-level ad blocker. It functions as a DNS server that automatically filters requests from advertising, tracking, and malicious domains, improving browsing and protecting the privacy of connected devices.

Prerequisites

• Linux operating system (recommended: Ubuntu, Debian, or derivatives).

• Access to an account with superuser (root) privileges.

• Internet connection.

Step 1: System Update

Before installing Pi-Hole, ensure that your system is up to date.

sudo apt update && sudo apt upgrade -y

Step 2: Install Dependencies

Install the necessary dependencies to run the Pi-Hole installer.

sudo apt install curl -y

Step 3: Download and Run the Pi-Hole Installer

Pi-Hole provides an automatic installation script.

curl -sSL https://install.pi-hole.net | sudo bash

Step 4: Installer Configuration

Follow the interactive steps of the installer:

1. Welcome Screen: Press "Enter" to continue.

2. Network Notice: Pi-Hole will act as a DNS server. Make sure you are ready to modify network settings.

3. Interface Configuration: Select the network interface to use (e.g., eth0 for wired or wlan0 for Wi-Fi).

4. Upstream DNS Provider: Choose a DNS provider (such as Google, Cloudflare, or OpenDNS).

5. Blocklist Configuration: Keep the default blocklist enabled or customize it as desired.

6. Static IP Configuration: Make sure to set a static IP to avoid losing the configuration after rebooting.

Step 5: Installation Completion

The installer will provide you with a password to access the web administration interface. You can change it using the following command:

pihole -a -p

Step 6: Access the Web Interface

Open your browser and access the Pi-Hole control panel:

http://<your_local_IP>/admin

Replace <your_local_IP> with your machine's IP address.

Step 7: Change DNS on Router or Devices

Configure your router or network devices to use the Pi-Hole IP address as the primary DNS server.

Useful Commands

• Check Pi-Hole Status:

  pihole status

• Update Pi-Hole:

  pihole -up

• Restart the Pi-Hole Service:

  sudo systemctl restart pihole-FTL

Troubleshooting

• Check the logs:

  tail -f /var/log/pihole.log

• Reinstallation: If something goes wrong, you can reinstall Pi-Hole by running the installation script again.

Security Recommendations

• Change the admin panel password periodically.

• Avoid exposing the Pi-Hole panel directly to the internet.

• Make backups of your custom blocklists.

---

Following these steps, your Pi-Hole will be configured to efficiently filter content within your local network.