From dc6f979c01ac79f7d834515f5e96f55a695b6842 Mon Sep 17 00:00:00 2001 From: mckaygerhard Date: Wed, 20 Jul 2022 16:42:59 +0000 Subject: [PATCH] tutorials - alpine over phone, improve the tutorial by uzeirselot * made it readable event in text mode only * fix the tutorial, was so centered in androit * provide limitations and issues section * add note about the GLIUBC and such problems --- ...nes-androit-allow-external-apps-install.md | 28 +++++ .../community-way/tutorial-alpine-in-phone.md | 109 +++++++++++++----- 2 files changed, 109 insertions(+), 28 deletions(-) create mode 100644 tutorials/community-way/phones-androit-allow-external-apps-install.md diff --git a/tutorials/community-way/phones-androit-allow-external-apps-install.md b/tutorials/community-way/phones-androit-allow-external-apps-install.md new file mode 100644 index 0000000..7177d15 --- /dev/null +++ b/tutorials/community-way/phones-androit-allow-external-apps-install.md @@ -0,0 +1,28 @@ +## how to allow install apks on a phone for open source projects + +### Android® 8.x & higher + +* From a Home screen, swipe up or down from the center of the display to access the apps screen, + or alternative goto the Main screen with all the apps using central button. +* Navigate: Settings ( the whell with toohs) then Apps +* Tap Menu icon (upper-right). +* Tap Special access +* Tap Install unknown apps +* Select the unknown app then tap the Allow from this source switch + to turn on Switch on or off Switch off. + +### Android® 7.x & lower + +* From a Home screen, navigate to Settings +* Tap Lock screen and security +* If unavailable, tap Security +* Tap the Unknown sources switch + to turn on or off. +* If unavailable, Unknown sources + to turn on or off. Enabled when check mark is present. +* To continue, review prompt then tap OK + +## See also + +* [tutorial-alpine-in-phone](tutorial-alpine-in-phone.md) + diff --git a/tutorials/community-way/tutorial-alpine-in-phone.md b/tutorials/community-way/tutorial-alpine-in-phone.md index 75a8b82..4cba766 100644 --- a/tutorials/community-way/tutorial-alpine-in-phone.md +++ b/tutorials/community-way/tutorial-alpine-in-phone.md @@ -1,35 +1,88 @@ +# Installing ALPINE LINUX on PHONEs -# INSTALL ALPINE LINUX ON PHONE! +You must take into consideration that there is really no standar way to replace +the phone's operating system, what is really done is to use the base of +the operating system and use a parallel operating system +(this in principle to explain it more simply). -## For iOS: -[Download iSH Shell](https://apps.apple.com/us/app/ish-shell/id1436902243) ->This app provides you Alpine-Linux,thats it! -___ +**What happened then?** you can boot inside yor phone (whitout remove the phone's OS), +the Alpine operating system, just like a kind of virtual machine but its not! -## For Android: -[Download Termux.apk](https://f-droid.org/repo/com.termux_118.apk) -> If link doesn't work then manually download and install from f-droid.org -> ->Install app,and follow more steps as follows: +If you want more help directly [ask for help here](../README.md#help-online-directly). -### To install Alpine-Linux,open termux app and use following command: - `pkg install git && curl -LO https://raw.githubusercontent.com/Hax4us/TermuxAlpine/master/TermuxAlpine.sh && bash TermuxAlpine.sh && startalpine` ->Copy-paste it in termux. -> ->Its successfully installed if no error is seen :) -___ +## Requirements -### To logout/exit Alpine-Linux: - `exit` +1. **IMPORTANT REQUIREMENT** Let's remember that you must have a minimum understanding +of Linux terminology, and this does not mean that you know it by using Mint or Ubuntu or WSL2. +2. Download a terminal subsystem, in the following table we will provide the respectives +in each phone cases and feature requirements: + +| OS | Version | Software to download | Minimal storage to use | Quick link to download | +| ------- | ------- | -------------------- | -------------------------- | ----------------------------------------------------- | +| iOS | 12.0+ | Download iSH Shell | 100Mb (its custom repo) | https://apps.apple.com/us/app/ish-shell/id1436902243 | +| Androit | 7.0+ | Download Termux | 240Mb (depends of version) | https://f-droid.org/repo/com.termux_118.apk | + +#### Issues when find apps for the phones + +* Its best to "Copy-paste" all commands in `Termux` or `iSH` to avoid errors. +* Its pretty important to check the [Limitations and issues](#limitations-and-issues) section before assume anything. +* On iOS maybe you must search over App store for the keyword "iSH" if the links provided does not work. +* On Androit maybe you must enable the **[Allow App Installations from Unknown Sources](phones-androit-allow-external-apps-install.md)** + +## Instalation + +#### On iOS and iSH + +The `iSH` uses the Alpine already embebed, so you may have to run apk update to fetch the Alpine repository list. + +The `iSH` has its own repositories so the app is entirely self-contained and iSH with apk can pass app review. +The repositories are a pseudo apk filesystem mounted on `/ish/apk` that when read, will actually download +from App Store as on-demand resources. It also means that Apple can review all packages in iSH's repositories. + +* open `iSH` app +* After open it, alpine its already started and runing in a terminal mode +* As optional get sure to get internet network by run `echo "nameserver 8.8.8.8" > /etc/resolv.conf` + +#### On Androit and Termux + +To install Alpine-Linux: + +* open `Termux` app +* run following command: + +``` +pkg install git + +curl -LO https://raw.githubusercontent.com/Hax4us/TermuxAlpine/master/TermuxAlpine.sh && bash TermuxAlpine.sh + +startalpine +``` + +* To logout/exit Alpine-Linux, just run `exit` until ends +* To start Alpine-Linux again open `Termux` and run `startalpine` +* As optional get sure to get internet network by run `echo "nameserver 8.8.8.8" > /etc/resolv.conf` + + +## Limitations and issues + +Sometimes you will receive an error `error relocating ... symbol not found` when running any installed tool. +This is because you installed some alpine packages too fresh but not upgraded dependences. +A simple `apk upgrade -a` will fix it. + +**IMPORTANT** to know: + +* For `Androit` and `Termux` you must read: https://wiki.termux.com/wiki/Differences_from_Linux +* For `iOS` and `iSH` you must read: https://github.com/ish-app/ish/wiki/What-works%3F + +## Refrence Sources + +* [iSH Github](https://github.com/ish-app/ish) +* [Termux Github](https://github.com/termux) +* [TermuxAlpine Github](https://github.com/Hax4us/TermuxAlpine) + +## See also + +* [Ask for help here](../README.md#help-online-directly) +* [About Alpine linux](../../alpine/about.md) -### To start Alpine-Linux again: - `startalpine` -___ -[Join our community.Help or discuss with us.](https://t.me/alpine_linux_english) ->https://t.me/alpine_linux_english -___ -#### *Refrence Sources* : -[iSH Github](https://github.com/ish-app/ish) -[Termux Github](https://github.com/termux) -[TermuxAlpine Github](https://github.com/Hax4us/TermuxAlpine)