Pi-hole-for-Android

Pi-hole for Android (Pi Deploy) uses a fork of Linux Deploy to simplify installaion of Debian Linux 12 to most rooted Android devices.

What's New (December 2023)

• Updated image to Debian 12 (Bookworm)
• Pi Deploy image is now 64 bit by default
• To deploy a 32 bit image, tap Properties and change the Source Path URL from /raspbian.tgz to /raspbian32.tgz

Note to users running previous version:

• The APK installer is unchanged (no need to re-install the Pi Deploy APK)
• If required, use Pi-hole Teleporter to back-up your existing configuration.
• Login to your existing deployment and run sudo unchroot uname -m. If your device returns armv7or armv8 your device is 32 bit and you need to change the Source Path URL to /raspbian32.tgz

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.

Pi-hole for Android (Pi Deploy) uses a fork of Linux Deploy to simplify installaion of Debian Linux 12 to most rooted Android devices.

What's New (December 2023)

• Updated image to Debian 12 (Bookworm)
• Pi Deploy image is now 64 bit by default
• To deploy a 32 bit image, tap Properties and change the Source Path URL from /raspbian.tgz to /raspbian32.tgz

Note to users running previous version:

• The APK installer is unchanged (no need to re-install the Pi Deploy APK)
• If required, use Pi-hole Teleporter to back-up your existing configuration.
• Login to your existing deployment and run sudo unchroot uname -m. If your device returns armv7 your device is 32 bit and you need to change the Source Path URL to /raspbian32.tgz

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.

Pi-hole for Android (Pi Deploy) utilizes a fork of Linux Deploy to simplify deployment of Raspbian to most rooted Android devices.

Note to users of previous builds:

• Uninstall any previous versions of Linux Depoy or Pi Deploy and reboot your device.
• Failure to heed this advice will cause issues!

Installation:

• Download and Install the latest 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)
• (Optional, post-install) To install PIXEL Desktop run pideploy-gui-install and restart the instance. Next time you login via RDP you will have a full desktop session with audio support.

• Uploaded p4a17b.tgz to fix xrdp and FTL compiler toolchain. Core v5.17.1 / FTL v5.23 / Web v5.20.1
• Uploaded p4a17a.tgz to include updated Nettle packages for pihole-FTL v5.19
• Update p4a-install
• Update rc.local init scripts
• Added ntp for time sync on startup
• Better handling of network discovery when device DNS is pointing at local Pi-hole instance
• Note: Enable Debug Mode in Settings to see console output below:

• Updated packagelist and sync release version with upstream
• Build pi-hole-FTL from source instead of binary download
• Shutdown and PowerOff options in Web Admin are working
• Added systemctl-shim to enable systemctl functionality

To update Pi-hole when upstream publishes new releases, connect to the Pi-hole instance via SSH or RDP and run the following command:

p4a-install

The equivalent command pihole -up will quit, reporting an unsupported distro.
Moving forward, you must use p4a-install to update Pi-hole.