diff --git a/README.md b/README.md index c4a3f3c2..85b97331 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Pi-hole is a network-level advertisement and Internet tracker blocking application for Linux which acts as a DNS sinkhole intended for use on a private network. It is designed for low-power embedded devices with network capability, focusing on the Raspberry Pi as its 'reference' hardware platform. -Pi-hole for Android is a CentOS disk image for [Linux Deploy](https://play.google.com/store/apps/details?id=ru.meefik.linuxdeploy&hl=en_US&gl=US) tuned to work with the Pi-hole installer. It works on any rooted Android device with an ARMv7 or newer CPU; this includes almost any Android device made in the past 10+ years. Form factor is not important; it could be a phone, tablet, HDMI stick or **any device running Android**. +Pi-hole for Android is a CentOS disk image for [Linux Deploy](https://play.google.com/store/apps/details?id=ru.meefik.linuxdeploy&hl=en_US&gl=US) that is tuned to work with the Pi-hole installer. It can be used on **any** rooted Android device with an **ARMv7 or newer CPU**; this includes almost any Android device made in the past 10+ years. Form factor is not important; it could be a phone, tablet, HDMI stick or **any device running Android**. **Requirements:** @@ -21,14 +21,14 @@ Pi-hole for Android is a CentOS disk image for [Linux Deploy](https://play.googl - Get the latest version at: **https://github.com/meefik/linuxdeploy/releases** - Android 4.x requires an older release: **https://github.com/meefik/linuxdeploy/releases/tag/2.5.1** -- Download the Pi-hole for Android disk image: (**v1.4 / December 23, 2021**) +- Download the Pi-hole for Android disk image: (**v1.5 / January 16, 2022**) - - **http://desktopecho.com/p4a14.tar.gz** (MD5: be609fbadbc1bcc3e0d5e46a2ca521d8) + - **http://desktopecho.com/p4a15.tar.gz** (MD5: f20ce97741a56fc599739bf830f53be9) - Open **Linux Deploy** and change ONLY these settings: - Open Properties Menu (Bottom Right) - Distribution: **rootfs.tar** - - Source Path - This varies depending on the device, ie: **${EXTERNAL_STORAGE}/Download/p4a14.tar.gz** + - Source Path - This varies depending on the device, ie: **${EXTERNAL_STORAGE}/Download/p4a15.tar.gz** - Set password for user **android** - Init -> **Enable** - Go back to main window, click **Options** Menu (Three dots, usually at top right of screen) and click **Install** @@ -42,7 +42,7 @@ Pi-hole for Android is a CentOS disk image for [Linux Deploy](https://play.googl `````[HH:mm:ss] >>> deploy````` - - **Before you continue, make sure the Linux Deploy Console is free of error messages.** If there are errors, troubleshoot by verifying the location of **p4a14.tar.gz** using a file manager as the path can vary by device. If you have trouble installing the image in Linux Deploy it may be because of SELinux. See this [post on XDA](https://forum.xda-developers.com/t/app-tool-2-0-official-the-selinux-switch.3656502/) for an APK to disable SELinux. + - **Before you continue, make sure the Linux Deploy Console is free of error messages.** If there are errors, troubleshoot by verifying the location of **p4a15.tar.gz** using a [file manager](https://github.com/DesktopECHO/Pi-hole-for-Android/wiki/Trouble-finding-path-where-Pi%E2%80%90hole-image-is-downloaded,-or-errors-are-reported-during-creation-of-Pi%E2%80%90hole-disk-image.) as the path can vary by device. If you have trouble installing the image in Linux Deploy it may be because of SELinux. See this [post on XDA](https://forum.xda-developers.com/t/app-tool-2-0-official-the-selinux-switch.3656502/) for an APK to disable SELinux. - Open the 'Hamburger menu' (Three dashes at top left) and touch **Settings** - Place checkmark on **Lock Wi-Fi** (If your device has Wi-Fi) @@ -60,9 +60,17 @@ Your Android device's IP is shown at the top of the Linux Deploy main window. Y - SSH to the instance on port 22 **-->** ```ssh android@10.13.12.11``` + - If your Android device has a display, you can RDP into the Pi-hole instance (as localhost) by installing the [Microsoft Remote Desktop](https://play.google.com/store/apps/details?id=com.microsoft.rdc.androidx) client. + - RDP to the device's IP address from a remote machine **-->** ```mstsc.exe /v:10.13.12.11``` - - If your Android device has a display, RDP "locally" by installing the [Microsoft Remote Desktop](https://play.google.com/store/apps/details?id=com.microsoft.rdc.androidx) client. +![image](https://user-images.githubusercontent.com/33142753/147254465-26443e85-6695-46e6-83f4-4c3ff1749804.png) + +**Pi-hole for Android wiki topics:** + +- [PADD is missing information / How to update](https://github.com/DesktopECHO/Pi-hole-for-Android/wiki/PADD-is-missing-information) +- [Setting custom disk/shmem alert thresholds](https://github.com/DesktopECHO/Pi-hole-for-Android/wiki/Setting-custom-alert-thresholds-for-disk-and-shmem-monitoring) +- [Linux Deploy - Trouble finding disk image or install location](https://github.com/DesktopECHO/Pi-hole-for-Android/wiki/Trouble-finding-path-where-Pi%E2%80%90hole-image-is-downloaded,-or-errors-are-reported-during-creation-of-Pi%E2%80%90hole-disk-image.) **Additional Info** @@ -72,6 +80,8 @@ When a Pi-hole instance starts up, the default setting is to let it automagicall Alternatively, set a static assignment by commenting-out two lines in ```/etc/rc.local``` (You will see which ones when you open the file in an editor.) After the lines are commented out with a hash "#" you can manually add your IP, subnet and interface name to ```/etc/pihole/setupVars.conf``` +Added [Unbound](https://www.nlnetlabs.nl/projects/unbound/about) to provide encrypted DNS by default; no addional configuration is necessary. + The Pi-hole instance on Android otherwise behaves like it is running on a 'real' Raspberry-Pi or a standard PC. Consult the extensive documentation online to learn how to fully leverage Pi-hole's functionality. Adjust QT display scaling: ```~/startwm.sh```