termux-alpine

Bash script to install Alpine Linux in Termux

Table of Contents

• Initializing
  • Installation
    • Launch Alpine Linux
  • Reinstall
  • Uninstall
• Upgrade
• Options
• Supports
• Contributing
• License

Initializing

Open the Termux app and copy-paste the following command:

pkg update -y && \
  pkg install -y git ncurses-utils && \
  cd $HOME && \
  git clone -b main https://github.com/illvart/termux-alpine.git && \
  cd termux-alpine && \
  chmod +x setup-termux-alpine

Installation

Installation options.

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

During installation, you will be asked to choose either the Edge or Latest Stable branch. Please follow the on-screen instructions!

Launch Alpine Linux

Simply run the following command in Termux:

termux-alpine

You can also run any command inside Alpine Linux like this:

termux-alpine echo "Hello World"

Reinstall

To reinstall, simply run the installation command, type y for yes and enter.

Note: Reinstalling will not remove anything inside /root/ and /home/.
If you have created or modified data outside these directories, please backup your data before reinstalling.

You can force a fresh reinstall by passing options, for example:

./setup-termux-alpine -S -F

Uninstall

Please backup your current installation before uninstallation.

Recommended method:

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

Manual (not recommended):

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

Upgrade

To upgrade the installation script, run the following commands:

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 use --setup-user, to login as the non-root user after installation use login your_username and enter the password.

Supports

If you’re enjoying it or want to support development, feel free to donate. Thank you! ❤️

Contributing

Want to contribute? Read the Contributing.

License

Released under the GPL-3.0 License.