Pi-hole for Android uses Pi Deploy, a fork of Linux Deploy to simplify installaion of Debian Linux to most rooted Android devices.
What's New (January 2024)
- Updated image to Debian 12 (Bookworm).
- Pi Deploy image is now 64-bit by default.
- If your Android build is 32-bit you need to configure Pi Deploy to use the correct image: Tap Properties and change the end of the Source Path URL from
/raspbian.tgz
to/raspbian32.tgz
- Switched to
curl
to fix SSL issues and improve download reliability. - Resolved RDP login issue on Android 13 and newer.
Note to users running previous version:
- This version incudes an updated APK installer.
- Login to your existing deployment and run
sudo unchroot uname -m
. If your device returnsarmv7
orarmv8
, your Android build is 32-bit and you must change the Source Path URL to/raspbian32.tgz
- Uninstall the old Pi Deploy build and reboot your device before installing the updated APK. Failure to do so will cause issues!
- If required, use Pi-hole Teleporter to back-up your existing configuration.
Installation:
- Download and Install the Pi Deploy APK
- Tap the Options menu (Three dots ⋮ at top right of screen)
- Tap New Deployment
- After a few moments the Raspbian Image will download and install to your device.
- When deployment is complete, tap [ ▷ START ] to launch the instance.
- The instance will provide you with a password for Pi-hole admin, SSH and RDP access (Username: android, see screenshot below)
- Note: The password appears only once when the image is deployed, make sure you record this information.
- Hint: The password text can be copy/pasted to other Android apps (like Remote Desktop)
Post-install add-ons:
-
To install PIXEL Desktop, run
pideploy-gui-install
. Next time you login via RDP you will have a full desktop session with audio support. -
For Nextcloud 27, run
pideploy-nextcloud-install
to launch the patched Nextcloudpi installer. Consult the official NextCloud documentation for administration of this powerful collaboration tool.