Skip to content

Commit

Permalink
Pi-hole for Android 1.5
Browse files Browse the repository at this point in the history
- Set qterminal to hide tab bar when only one tab is open
- Fixed bug in rc.local
- Can now be installed as disk image or directly in filesystem
- Fixes for installer/uninstaller
- PADD will now self-update at startup
  • Loading branch information
DesktopECHO committed Jan 17, 2022
1 parent 0d0355d commit b22b064
Showing 1 changed file with 16 additions and 6 deletions.
22 changes: 16 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:**

Expand All @@ -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**
Expand All @@ -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)
Expand All @@ -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 [email protected]```

- 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**

Expand All @@ -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```
Expand Down

0 comments on commit b22b064

Please sign in to comment.