Home

Awesome

termux-alpine

Release License: GPL-3.0 CI Status

Bash script for installing Alpine Linux in Termux.

<p align="center"> <img src="https://github.com/illvart/termux-alpine/blob/main/ss.png?raw=true" alt="Alpine Linux Termux"/> <br> <em>Check out the other screenshots on my <a href="https://www.instagram.com/illvart_">Instagram</a>.</em> </p>

Table of Contents

<details> <summary>Details</summary> </details>

Initializing

Open Termux app, copy and paste the following command in Termux.

Note: Required to install git and ncurses-utils, skip if already installed!

pkg install -y git
pkg install -y ncurses-utils

cd $HOME && \
    git clone -b main https://github.com/illvart/termux-alpine.git && \
    cd termux-alpine && \
    chmod +x setup-termux-alpine

Or download from GitHub Releases page and extract.

Installation

Installation options.

./setup-termux-alpine --setup-user

Please follow the output of the command above!

Launch Alpine Linux

Just typing a command like below in Termux and enter.

termux-alpine

You can also running any commands inside Alpine Linux:

termux-alpine echo "Hello World"

Reinstall

To reinstall just typing a command like installation above, type y for yes, and enter.

Or pass the command with options example:

./setup-termux-alpine -S -F

Uninstall

Please note! Before uninstalling, recommended to backup the current installation.

cd ${HOME}/termux-alpine && \
    ./setup-termux-alpine --uninstall

Or manually (isn't safe):

rm -rf ${PREFIX}/bin/termux-alpine \
    ${HOME}/.alpine

Upgrade

Upgrade the installation script.

rm -rf ${HOME}/termux-alpine && \
    cd $HOME && \
    git clone -b main https://github.com/illvart/termux-alpine.git && \
    cd termux-alpine

Options

Usage: ./setup-termux-alpine [options]

Options:
--install-nodejs	install nodejs-current, npm, and yarn
--install-python3	install python3 py3-pip, and py3-wheel
-S, --setup-user	setup a non-root user
-F, --fake-kernel	use a fake kernel
-u, --uninstall		full wipe the rootfs installation
-v, --version		show this program version
-h, --help		show this help information

If you're using --setup-user, to login a non-root user after installation use login your_username and enter the password.

:sparkling_heart: Supports

This project is open source and free to use under the license. However, if you are using this project and happy with it or just want to encourage me to continue creating stuff please donate!

Credits

Credit to Hax4us and termux for source.

Contributing

If you would like to help out with some code, check the details.

License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.