Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/termux/termux-app/llms.txt

Use this file to discover all available pages before exploring further.

Termux is distributed through three sources: F-Droid, GitHub, and the Google Play Store. Each source signs its APKs with a different key, which has an important consequence: Termux and every plugin app installed on your device must come from the same source. Mixing sources causes installation failures and prevents plugins from communicating with the core app.
APKs from different sources are signed with different keys. Termux and all its plugin apps (Termux:API, Termux:Boot, Termux:Float, Termux:Styling, Termux:Tasker, Termux:Widget) share the user ID com.termux and must all be installed from the same source. Installing from mixed sources produces errors like INSTALL_FAILED_UPDATE_INCOMPATIBLE or signatures do not match previously installed version. If you want to switch sources, uninstall every Termux app and plugin before reinstalling.

Installation sources

System requirements

RequirementMinimum
Android version7.0 (API 24) for full app and package support
Android version5.0–6.0 (API 21–23) for app only, via GitHub builds — no package updates
Architecturearm64-v8a, armeabi-v7a, x86_64, x86
Install locationInternal storage only (android:installLocation="internalOnly")
Support for Android 5 and 6 was dropped in January 2020 at v0.83 and re-added in May 2022 specifically for the GitHub source via the apt-android-5 APK variant. Package repositories do not receive updates for Android 5/6 devices.

Installing plugins

Install plugins only after you have installed the core Termux app, and only from the same source: Each plugin is a separate APK available from the same F-Droid, GitHub, or Google Play source as the core app. Installing a plugin from a different source than the core app will fail.

Uninstalling Termux

Before uninstalling — for example, to switch from F-Droid to GitHub builds — consider backing up your Termux data so you can restore it after reinstalling. To completely remove Termux from your device:
  1. Go to Android SettingsApplications.
  2. Search for termux in the application list.
  3. Uninstall every app that appears: Termux, Termux:API, Termux:Boot, Termux:Float, Termux:Styling, Termux:Tasker, and Termux:Widget.
Even if you believe you have not installed any plugins, check the full application list. Partial uninstallation leaves conflicting signed packages that will block a clean install from a new source.

Build docs developers (and LLMs) love