🚀 Getting Started
Follow these steps to connect the app to your Pi-hole and start managing it from your phone.
1. Install the app​
You can get Pi-hole Client in one of two ways:
- Google Play — easiest way to install and receive updates
- GitHub Releases — for manual APK installation or testing newer builds
tip
For Linux or Windows users, see the Installation Guide for detailed setup instructions and dependency notes.
2. Prepare your Pi-hole​
Before connecting:
-
Make sure your Pi-hole web interface is reachable from your phone (same LAN, or via VPN like WireGuard / Tailscale).
-
Confirm your Pi-hole version is v6:
pihole -v
For Pi-hole v6​
- You'll need the Web UI password you set during installation.
For Pi-hole v5​
- Find your API key in
Settings → API/Web interface → Show API token. See Getting the API token (v5 only) for details.
🔗 3. Add your server in the app​
🚧🚧🚧 Work in progress 🚧🚧🚧