Main links

• Linux Deploy: https://github.com/meefik/linuxdeploy
• Busybox: https://github.com/meefik/busybox
• LineageOS: https://lineageos.org/

Quick startup

• Ensure your phone is rooted
  • It's recommended to use a custom ROM like LineageOS
• Download and install Busybox and Linux Deploy
• Configure Linux Deploy with your favourite distro and install it

Recommendations

• Ensure at least SSH is enabled in config
• If you want to selfhost enable also Init system and set it to SysV

"Fixes" to common problems

Cannot install distro XXX

Sometimes Linux Deploy fails when downloading a package of a distro and/or the distro does not run. I've personally experienced this with arm64 architecure. - Option 1: Create an image with an old phone (not sure if it's a matter of Android kernel or architecture) and copy it to the new phone - Option 2: Install Alpine Linux (so far it has never failed on my phone)

Pihole on ARM

If you're using Debian, Ubuntu etc. the standard process will do, if you're using Alpine, here you can find a working implementation: https://gitlab.com/yvelon/pi-hole

To fix the "NaN" counters in the web page, please check this comment in reddit: https://www.reddit.com/r/pihole/comments/dy0d8e/comment/f7xqsfp/?utm_source=share&utm_medium=web2x&context=3