How to Install Termux on Android (Without Root) | Setup Termux | Termuxgenius
How to Install Termux on Android (Without Root)
Termux turns an Android phone or tablet into a genuine Linux command-line environment — no root access required. It's useful for learning shell commands, running Python or Node.js scripts on the go, managing files, or trying networking utilities for legitimate testing and study. This guide covers the current correct way to install it, get storage working, and set up a usable toolset.
What Termux Actually Is
Termux is a terminal emulator paired with a minimal Linux-compatible package system (based on Debian's), running inside Android's normal app sandbox. It doesn't virtualize a full OS or need root — it runs natively, which is why it stays lightweight even on mid-range phones. Through its package manager (pkg), you can install interpreters, compilers, editors, and command-line utilities much like on a Debian-based Linux machine.
What it's genuinely good for:
- Learning and practicing Linux/shell commands
- Writing and running scripts in Python, Node.js, or similar languages
- Lightweight file and text management from the command line
- Trying networking utilities for legitimate, authorized testing and learning — see our guide on using Termux for ethical hacking
What it's not:
- A full desktop OS replacement for heavy GUI workflows
- A way to gain root or bypass Android's security model
- A tool for testing systems or networks you don't own or have explicit permission to test
Install Source: Why It Matters
The version of Termux distributed through the Google Play Store hasn't received updates since 2020, because Android's newer app-targeting requirements broke its ability to install and update packages reliably. Installing that version is the single most common cause of package errors — see our dedicated fix for the "unable to locate package" error if you're already stuck.
There are two currently maintained sources:
| Source | Best for |
|---|---|
| F-Droid | Most users — auto-updates through the F-Droid app once subscribed to its repo |
| GitHub Releases (official termux/termux-app repo) | Users who want the newest build immediately, or a specific architecture variant, without waiting for F-Droid to catch up |
F-Droid releases are built and published once the F-Droid project detects a new GitHub release, so GitHub updates typically land on F-Droid a few days to a week later. Either source is legitimate and safe. You cannot install the F-Droid or GitHub version over an existing Play Store install — they use different signing keys, so uninstall the Play Store version first if you have it.
Steps
- Go to f-droid.org, download the F-Droid client, and install it (allow installation from unknown sources when prompted). Or go to the termux/termux-app GitHub repository's Releases page and download the correct APK for your device's architecture directly.
- Open F-Droid, search "Termux," and install the app maintained by the Termux project.
- Open Termux once installation finishes.
Initial Setup
Update the package lists and upgrade everything before installing anything else — this avoids most early compatibility errors. Full walkthrough here: updating and upgrading packages in Termux.
pkg update && pkg upgrade
Storage Permissions
Termux is sandboxed by default and can only see its own private directory. To reach your phone's shared storage (Downloads, DCIM, etc.), run:
termux-setup-storage
Tap Allow on the permission prompt. This creates a ~/storage folder in Termux with symlinks into your shared storage.
If this fails or nothing shows up in ~/storage: on Android 11 and newer, scoped storage rules mean the simple permission prompt sometimes isn't enough. Go to Settings → Apps → Termux → Permissions → Files and media, and enable All files access manually, then rerun the command above. If it still doesn't work, see our full breakdown: fixing Termux storage permission issues.
Installing Essential Packages
A reasonable starting toolkit:
pkg install git python curl wget nano nodejs
| Package | What it's for | Learn more |
|---|---|---|
| git | Version control, cloning repositories | Installing Git & cloning repos |
| python | General-purpose scripting and programming | Installing Python in Termux |
| curl / wget | Downloading files from the command line | — |
| nano | Simple in-terminal text editor | Using Nano and Vim in Termux |
| nodejs | Running JavaScript outside the browser | Installing Node.js and npm |
Core Commands to Know
These commands form the foundation of daily Termux use. For the complete list with more examples, see our Termux basic commands guide for beginners.
| Command | Purpose | Example |
|---|---|---|
| pwd | Show current directory | pwd |
| ls -la | List files, including hidden ones | ls -la |
| cd | Change directory | cd ~/storage/downloads |
| mkdir | Create a folder | mkdir project |
| touch | Create an empty file | touch script.py |
| cat | Print a file's contents | cat notes.txt |
| python script.py | Run a Python file | python script.py |
Extending Termux with Official Add-ons
Once the base setup is working, two official companion apps extend what Termux can do without any extra risk, since they're built and signed by the same project:
- Termux:Widget — adds home-screen shortcuts that launch saved scripts with one tap. See installing and using Termux:Widget.
- Termux:API — exposes Android features (GPS, notifications, SMS, clipboard) to your scripts. See how it compares in Termux vs Termux:API: what's the difference.
Install these from F-Droid only — mixing a Play Store Termux with an F-Droid add-on causes signature-mismatch errors and the add-on simply won't connect.
Remote Access and Automation
Once your base setup is solid, two things most people eventually want are remote access and task automation:
Pros and Cons
Pros
- No root required
- Genuinely lightweight compared to a VM or emulator
- Active package repository covering most common CLI tools
- Works offline once packages are installed
Cons
- Storage permission setup can be finicky on newer Android versions
- Battery/background-process limits on some Android skins can kill long-running sessions
- No built-in GUI — desktop-style use requires extra setup and isn't as smooth as a real desktop
- Learning curve if you've never used a Linux shell before
A Note on Security Tools
Termux can run legitimate networking and diagnostic tools for learning or for testing systems you own or are explicitly authorized to test. Two cautions worth taking seriously:
- Don't run install scripts from repositories you haven't reviewed. Piping a random GitHub script straight into bash is a common way people compromise their own device.
- Only test networks and systems you have explicit permission to test. Unauthorized scanning or intrusion attempts are illegal in most jurisdictions.
Common Mistakes
- Installing from the Play Store, then wondering why packages fail to install or update
- Skipping
pkg update && pkg upgradebefore installing other packages - Assuming termux-setup-storage failing means Termux is broken, rather than checking app permissions first
- Running scripts from unfamiliar sources without reading them first
Who Termux Isn't For
If you need a full graphical Linux desktop experience out of the box, or heavy IDE-based development, a cloud development environment or an actual laptop will serve you better with far less setup friction. Termux shines for command-line work, scripting, and learning — not as a full desktop replacement without extra configuration.
FAQ
Do I need to root my phone to use Termux?
No. Termux runs entirely within Android's normal app permissions.
Why shouldn't I use the Play Store version?
It hasn't been updated since 2020 and can't reliably install or update packages due to Android's newer app-targeting restrictions. F-Droid or the official GitHub Releases page are the current supported sources.
termux-setup-storage isn't working — what do I do?
Manually enable "All files access" for Termux in Android's app permission settings, then rerun the command. See our full storage permission fix if that doesn't resolve it.
Is it safe to install security tools in Termux?
The tools themselves are legitimate and widely used for learning and authorized testing. The risk isn't the tool — it's running unreviewed installation scripts, or using tools against systems you don't have permission to test.
Can I run a GUI or desktop apps in Termux?
To a degree, via extra setup, but it won't match the smoothness of a native desktop. Better thought of as a bonus than the default use case.
Join the conversation