Installing Termux on an Android phone is not hard, but if you do it the wrong way, you’ll run into a headache of errors later on. Many beginners install Termux from the Play Store and then wonder why packages fail, updates break, or tools do not work at all.
In this guide, I will show you the right way to install Termux manually on Android. This method works on most Android phones, you don’t need to "root" your device, and it helps you avoid the common mistakes that waste time and cause frustration.
By the end of this post, you will have a clean and working Termux setup that is ready for learning, scripting, and everyday Linux practice on your phone.
Why You Should Not Install Termux from the Play Store
Many people install Termux from the Google Play Store because it feels like the safest option. In this case, it is not.
The Play Store version of Termux is outdated and no longer maintained. It does not receive updates, security fixes, or proper package support. Because of this, many tools fail to install, commands return errors, and some features simply do not work.
If you use the Play Store version, you may think Termux is broken, while the real problem is the source. This is one of the most common mistakes beginners make.
To avoid these issues, Termux should be installed from trusted sources that still provide active updates. This ensures better stability, working packages, and fewer problems as you learn and experiment.
Download Termux from F-Droid (Step by Step)
To avoid problems later, you need to install a version of Termux that is still actively maintained. The safest way to do this is by downloading the official APK from F-Droid.
Step 1: Open the Termux Page on F-Droid
First, open your browser and go to the official Termux page on F-Droid:
https://f-droid.org/packages/com.termux/This page is managed by F-Droid and hosts the official Termux releases. It is a trusted source and recommended by the Termux developers.
Step 2: Scroll Down to the Download Section
Once the page loads, scroll all the way down to the bottom. You will see a list of available versions of Termux.
Do not rush this step. Many beginners accidentally download an old version because they click the first button they see.
Check the Release Date:Each version listed on the page shows a date added. Always look at this date.
The newest version will have the most recent date. This is the version you want to install. Older versions may still work, but they can cause package errors or missing features later.
Taking a few seconds to confirm the date can save you a lot of trouble.
Step 3: Download the Latest APK
After confirming the newest version, tap on Download APK.
Your browser will start downloading the file. The file size is small, so it should not take long even on a slow connection.
Step 4: Install the APK File
When the download finishes, tap on the APK file to start the installation.
If Android shows a warning about installing apps from unknown sources, allow it for your browser or file manager. This is normal when installing apps manually and does not mean the file is unsafe.
Complete the installation like any other Android app.
Step 5: Open Termux and Confirm It Works
After installation, open Termux from your app drawer.
You should see a simple black terminal screen waiting for input. If Termux opens without crashing or showing errors, the installation was successful.
Alternative installation options:
If you prefer, you can also install Termux from the official GitHub releases here or from trusted APK mirror sites such as https://termux.en.download.it/android. If you choose this option, always check the release date and source to avoid installing an outdated or modified version.
At this point, do not install any tools yet. In the next section, you will update Termux and set it up properly so everything works as expected.
Update and Set Up Termux Properly
After installing Termux, the first thing you should do is update it. This step is important and should never be skipped. A fresh install may come with outdated package information, which can cause errors when installing tools.
Step 1: Open Termux
Open the Termux app. You will see a black screen with a blinking cursor. This is where you type commands.
Do not worry if it looks unfamiliar. You only need to type exactly what is shown.
Step 2: Update Package Lists and Upgrade Packages
Type the following command and press Enter:
pkg update && pkg upgrade -yThis command does two things:
-
pkg updaterefreshes the list of available packages -
pkg upgradeupdates any installed packages to the latest versions
The -y option automatically agrees to prompts, so you do not need
to press yes multiple times.
During this process, you may see a lot of text scrolling on the screen. This is normal. Let it finish without closing the app.
Step 3: Install Basic Tools
Once the update is complete, install a few basic tools that are commonly used in Termux.
Run these commands one by one:
pkg install git -ypkg install wget -ypkg install curl -yHere is why these tools matter:
-
git is used to download and manage projects from repositories
-
wget helps download files directly from the internet
-
curl is used for testing connections and working with web data
You may not use them immediately, but many tutorials and tools depend on them.
Step 4: Confirm the Installation
After installing the tools, you can confirm they are working by typing:
git --versionIf you see a version number, it means the installation was successful.
At this point, your Termux environment is updated and ready. In the next section, you will grant storage permission so Termux can access files on your phone, which is required for many tasks.
Grant Storage Permission in Termux
By default, Termux cannot access files on your Android device. This means you cannot read, save, or edit files from your internal storage unless you give Termux permission.
This step is required if you plan to work with downloads, scripts, text files, or any local files on your phone.
Step 1: Run the Storage Setup Command
Open Termux and type the following command, then press Enter:
termux-setup-storageThis command tells Android that Termux wants permission to access your device storage.
Step 2: Allow the Permission
After running the command, Android will show a permission prompt.
Tap Allow.
If you deny this permission, Termux will still work, but you will not be able to access files outside the app. Many beginners skip this step and later think something is broken.
Step 3: Understand What Changed
Once permission is granted, Termux creates a folder called storage inside your home directory.
This folder contains shortcuts to common Android locations, such as:
- Internal storage
- Downloads
- Pictures
- Music
These are not new folders. They are links that allow Termux to safely access your existing files.
Step 4: Verify Storage Access
To confirm that storage access works, type:
ls storage
If you see folders like
downloads or shared, the setup was successful.
Now Termux can read and write files on your device, which is essential for learning Linux commands, editing scripts, and working with downloaded tools.
Conclusion
You now have Termux installed the right way and set up properly on your Android device. By avoiding the Play Store version and using a trusted source, you reduce errors, broken packages, and unnecessary frustration.
Taking time to update Termux and grant storage permission ensures that basic tools work as expected. This gives you a stable environment for learning Linux commands, writing scripts, and experimenting safely on your phone.
If you are just getting started, focus on understanding the basics before installing advanced tools. Keep your packages updated and always be mindful of how you use Termux. When used responsibly, it is a powerful learning tool that fits right in your pocket.
Bookmark this guide if you need it later, and share it with anyone who wants to start using Termux without running into common setup problems.
