mirror of
https://codeberg.org/alpine/alpine-wiki.git
synced 2023-08-25 13:53:16 +02:00
106 lines
4.7 KiB
Markdown
106 lines
4.7 KiB
Markdown
# Installing ALPINE LINUX on PHONEs
|
||
|
||
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).
|
||
|
||
**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!
|
||
|
||
If you want more help directly [ask for help here](README.md#help-online-directly).
|
||
|
||
## Introduction
|
||
|
||
TERMUX or ISH are applications providing linux like environment.
|
||
|
||
Using Alpine-linux is beneficial for programmers,computer science students,
|
||
|
||
## Requirements
|
||
|
||
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.
|
||
|
||
> **Warning** **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)
|
||
|
||
# LICENSE
|
||
|
||
**CC BY-NC-SA**: this project allows reusers to distribute, remix, adapt, and build upon the material
|
||
in any medium or format for noncommercial purposes only, and only so long as attribution is given
|
||
to the creators involved. If you remix, adapt, or build upon the material, you must license the modified
|
||
material under identical terms, includes the following elements:
|
||
|
||
* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor.
|
||
* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here!
|
||
* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it.
|
||
|
||
For more information check the [../alpine/copyright.md](../alpine/copyright.md)
|
||
|