Complete Termux Setup Guide for Beginners 2026 — Everything in One Place



Termux · Linux · Android

Complete Termux Setup Guide for Beginners 2026 — Everything You Need to Get Started

🆓 Free 🤖 No Root Required 📱 Android ✅ Tested 2026

// 01 — Introduction: What Is Termux and Why Should You Care?

If you've ever wanted to run real Linux commands on your Android phone without rooting it, then Termux is the single most powerful tool you can install today. Termux is a free, open-source terminal emulator and Linux environment for Android that requires absolutely no root access. In 2026, Termux has grown into one of the most popular developer tools on Android, with millions of users worldwide using it for scripting, coding, cybersecurity learning, network analysis, and even running full Linux distributions on their phones.

This complete Termux setup guide for beginners will walk you through every single step — from downloading Termux correctly, to running your first commands, installing packages, navigating the file system, and even customizing your terminal so it looks and feels exactly the way you want. Whether you're a student curious about Linux, an aspiring developer, or someone just starting their cybersecurity learning journey, this guide has everything you need.

What makes Termux so special is how lightweight and capable it is. You're not running a virtual machine or an emulator in the traditional sense — Termux uses Android's Linux kernel directly, giving you a genuine command-line Linux environment right in your pocket. You can run Python scripts, use Git, connect via SSH, install programming languages, and access hundreds of packages from the command line, all without needing a laptop or desktop computer.

Rixon Xavier, the founder of HYDRA TERMUX and the author of this guide, has been teaching Android users how to get the most out of Termux since 2023. In that time, the single most common problem beginners face is not knowing where to start or installing Termux from the wrong source. This guide solves both of those problems completely.

By the time you finish reading, you'll have a fully configured Termux environment ready for coding, learning, and exploration. Let's get into it.

// 02 — Installing Termux the Right Way in 2026

This is the most important section in this entire guide, and it's where most beginners go wrong. In 2026, there are two places you might find Termux — the Google Play Store and F-Droid. Here's the critical thing you must know: the Google Play Store version of Termux is outdated and no longer maintained. The Termux developers officially abandoned it years ago. If you install from the Play Store, you'll run into broken packages, outdated repositories, and a frustrating experience. Always install Termux from F-Droid.

⚠️
Warning: Do NOT install Termux from the Google Play Store. It is severely outdated. Always use F-Droid or the official GitHub releases page for the latest working version.

Method 1: Install Termux via F-Droid (Recommended)

F-Droid is a free and open-source Android app store that hosts only open-source apps. It's the official distribution channel for Termux in 2026.

01

Download F-Droid

Open your browser and go to f-droid.org. Download and install the F-Droid APK. You'll need to allow installation from unknown sources in your Android settings.

02

Enable Unknown Sources

Go to Settings → Security → Install Unknown Apps (exact path varies by device). Enable it for your browser app so you can install APKs downloaded from the web.

03

Search for Termux in F-Droid

Open F-Droid, wait for the repository to update, then search for Termux. Tap Install. The app ID should be com.termux.

04

Launch Termux

Once installed, open Termux. You'll see a black terminal screen with a blinking cursor. That's your Linux environment. You're in.

Method 2: Install via GitHub Releases

If you prefer not to use F-Droid, you can download Termux APK directly from the official GitHub releases page at github.com/termux/termux-app/releases. Always download the latest stable release. Look for the file ending in -universal-release.apk for maximum device compatibility.

💡
Tip: After installing Termux, also consider installing Termux:API and Termux:Widget from F-Droid. These add-on apps extend Termux with Android system access and home screen shortcuts respectively.

Granting Storage Permission

One of the first things you should do after opening Termux is grant it storage access so it can read and write files in your phone's internal storage. Run this command:

bash copy
termux-setup-storage

A permission dialog will pop up on your screen. Tap Allow. This creates a ~/storage folder inside Termux with symlinks to your phone's Downloads, Pictures, Music, and other directories. Without this step, Termux is isolated from your phone's file system, which severely limits what you can do.

// 03 — Essential First-Time Setup Commands for Termux

Now that Termux is installed and storage is set up, it's time to configure your environment properly. These are the commands every beginner should run immediately after installing Termux. Think of this as the "first boot" setup sequence — do these once, and your environment will be ready for anything.

Step 1 — Update and Upgrade All Packages

The very first command you should ever run in a fresh Termux install is the update-upgrade sequence. This syncs your package list with the latest repositories and upgrades any pre-installed packages to their newest versions.

bash copy
pkg update && pkg upgrade

When prompted with [Y/n] questions, type Y and press Enter to confirm. This process may take a few minutes on first run. pkg update refreshes the list of available packages from the repositories, while pkg upgrade installs the newer versions of everything already on your system.

💡
Tip: Run pkg update && pkg upgrade every week or two to keep your Termux environment secure and up-to-date. Outdated packages are one of the most common causes of errors in Termux.

Step 2 — Install Core Utilities

Termux ships with a minimal set of tools by default. You'll want to install a few essential utilities right away that make the terminal much more usable and powerful.

bash copy
pkg install curl wget git nano vim -y

Here's what each of these does: curl is a command-line tool for transferring data from URLs — you'll use it constantly for downloading files and testing APIs. wget is another download utility, great for mirroring websites or downloading files non-interactively. git is the world-standard version control system — essential for any developer. nano is a simple, beginner-friendly text editor that works right inside the terminal. vim is a powerful (though steeper learning curve) terminal editor beloved by power users.

Step 3 — Install Python

Python is one of the most important programming languages for scripting, automation, data science, and cybersecurity. Installing it in Termux is one command:

bash copy
pkg install python -y

After installation, verify it works:

bash copy
python --version

You should see something like Python 3.12.x. You can now run Python scripts directly in Termux — no laptop needed.

Step 4 — Set Up a Login Shell Greeting (Optional but Useful)

You can configure a message or useful information to display every time you open Termux by editing the .bashrc file:

bash copy
nano ~/.bashrc

Add a line like echo "Welcome to your Termux environment!" at the top. Save with Ctrl+X, then Y, then Enter. Now every time you open Termux, that message appears.

// 04 — Navigating the Termux File System Like a Pro

Understanding Termux's file system is crucial because it's laid out differently from a standard desktop Linux distribution. When you open Termux, you land in your home directory, which is located at /data/data/com.termux/files/home. This is a private directory inside Android's app sandbox. Let's learn how to move around it and understand its structure.

Essential Navigation Commands

bash copy
# Print current directory
pwd

# List files and folders
ls

# List with details (permissions, size, date)
ls -la

# Change to home directory
cd ~

# Go up one level
cd ..

# Go to a specific folder
cd Downloads

# Create a new folder
mkdir my_projects

# Remove a file
rm filename.txt

# Remove a folder and its contents
rm -rf foldername

Understanding the Termux Directory Structure

Termux has its own isolated Linux environment. The root of this environment is at /data/data/com.termux/files. Inside, you have two main directories: usr (where all installed packages live) and home (your personal workspace). When you type ~ in any command, it refers to home.

After running termux-setup-storage, a storage folder appears in your home directory. This is your bridge to Android's file system:

bash copy
# Access your phone's Downloads folder from Termux
cd ~/storage/downloads

# Access your phone's Pictures
cd ~/storage/pictures

# Access all shared storage
cd ~/storage/shared
Once you understand ~/storage, you can read and write files anywhere on your phone from the Termux terminal — scripts, images, documents, everything.

Working with Files

bash copy
# Create an empty file
touch hello.txt

# Write text into a file
echo "Hello, Termux!" > hello.txt

# Read a file
cat hello.txt

# Copy a file
cp hello.txt hello_backup.txt

# Move (rename) a file
mv hello.txt greetings.txt

# Search for text inside files
grep "Hello" greetings.txt

// 05 — Installing Your First Packages and Tools in Termux

One of the best things about Termux is its extensive package repository. You can install hundreds of real Linux tools directly from the command line using the pkg command (which is Termux's wrapper around the apt package manager). In this section we'll explore how the package system works and install some genuinely useful tools.

How the pkg Command Works

bash copy
# Install a package
pkg install packagename

# Remove a package
pkg uninstall packagename

# Search for available packages
pkg search keyword

# Show info about a package
pkg show packagename

# List all installed packages
pkg list-installed

# Update package lists
pkg update

# Upgrade all installed packages
pkg upgrade

Must-Have Packages for Beginners

Here's a curated list of the most useful packages for anyone just getting started with Termux. Install them all at once with this command:

bash copy
pkg install git python nodejs ruby perl nmap openssh net-tools -y

git — Version control for all your code projects. Clone repositories from GitHub, track changes, push and pull code. Essential for any developer. python — The world's most versatile scripting language. Use it for automation, data processing, web scraping, and much more. nodejs — JavaScript runtime for building server-side apps and running JS scripts on the command line. ruby — Elegant scripting language used by tools like Metasploit (for educational use). perl — Classic Unix scripting language, still widely used in system tools. nmap — Network mapper — a standard tool in every network engineer's toolkit for scanning and discovering devices on your own network. openssh — Lets you connect to remote servers via SSH, and also run an SSH server on your own device. net-tools — Classic networking utilities including ifconfig, netstat, and more.

Installing Programming Languages

Termux supports a huge variety of programming languages. Here are the install commands for the most popular ones:

bash copy
# Python 3
pkg install python -y

# Node.js + npm
pkg install nodejs -y

# PHP
pkg install php -y

# Go (Golang)
pkg install golang -y

# Rust
pkg install rust -y

# Java (OpenJDK)
pkg install openjdk-17 -y

# C / C++ compiler
pkg install clang -y
💡
Tip: Don't install everything at once. Install what you need as you need it. This keeps your Termux environment clean and avoids unnecessary storage use on your Android device.

Using pip to Install Python Libraries

Once Python is installed, you can use pip to install thousands of Python libraries:

bash copy
# Install pip (usually comes with Python)
pip install --upgrade pip

# Install requests library (for HTTP)
pip install requests

# Install beautifulsoup4 (for web scraping)
pip install beautifulsoup4

# Install numpy (for math/data)
pip install numpy

# List installed pip packages
pip list

// 06 — Customizing Termux — Make It Yours

A default Termux install is functional, but it's not particularly pretty or efficient to use. Customizing your Termux environment makes it faster to work in, easier on the eyes, and simply more enjoyable. In this section we'll cover color schemes, fonts, keyboard shortcuts, and shell upgrades that every serious Termux user should know about.

Changing the Color Scheme and Font

Termux reads its visual settings from a file called ~/.termux/colors.properties for colors and ~/.termux/font.ttf for the font. The easiest way to customize both is with the termux-style tool or by manually editing the properties file.

bash copy
# Create the .termux directory if it doesn't exist
mkdir -p ~/.termux

# Open the colors file for editing
nano ~/.termux/colors.properties

Here is an example dark cyberpunk color scheme you can paste in:

properties copy
background=#0d0d0d
foreground=#00ff41
cursor=#00ff41
color0=#000000
color1=#ff0055
color2=#00ff41
color3=#ffcc00
color4=#0088ff
color5=#ff00ff
color6=#00ffff
color7=#ffffff
color8=#555555
color9=#ff4444
color10=#44ff44
color11=#ffff44
color12=#4488ff
color13=#ff44ff
color14=#44ffff
color15=#ffffff

After saving, apply the change by running:

bash copy
termux-reload-settings

Upgrading Your Shell — Install ZSH with Oh My Zsh

Termux's default shell is bash, which is perfectly functional. But many power users switch to zsh with the Oh My Zsh framework for better autocomplete, syntax highlighting, themes, and plugins. Here's how:

bash copy
# Install zsh
pkg install zsh -y

# Install Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Set zsh as default shell
chsh -s zsh

Installing Useful Zsh Plugins

bash copy
# Syntax highlighting plugin
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# Autosuggestions plugin
git clone https://github.com/zsh-users/zsh-autosuggestions \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

Then open your ~/.zshrc and find the plugins=(git) line. Change it to:

bash copy
plugins=(git zsh-syntax-highlighting zsh-autosuggestions)

Useful Keyboard Shortcuts in Termux

Termux has a special extra key row at the top of the keyboard and supports volume-key shortcuts. Here are the most important ones to know:

Shortcut What It Does
Volume Down + CCtrl+C — Interrupt/cancel a running command
Volume Down + DCtrl+D — Exit current session / EOF
Volume Down + ZCtrl+Z — Suspend a process
Volume Down + LClear screen (like clear)
Long press screenCopy/Paste menu
Swipe right from left edgeOpen sessions sidebar

Setting Up a Custom Motd (Message of the Day)

Termux displays a welcome message every time it starts, stored at $PREFIX/etc/motd. You can customize it to show useful info:

bash copy
nano $PREFIX/etc/motd

Replace the default message with anything you like — your name, a reminder, ASCII art, or even a dynamic command output.

// 07 — Common Termux Errors and How to Fix Them

Even with a clean setup, you'll run into errors eventually. Here are the most common ones beginners encounter, and exactly how to fix each one.

Error: "Unable to install" or "Package not found"

bash copy
# Fix: Update your package lists first
pkg update

# Then try installing again
pkg install packagename

Error: "E: Sub-process /usr/bin/dpkg returned error code"

bash copy
# Fix: Force configure any broken packages
dpkg --configure -a

# Then run upgrade again
pkg upgrade

Error: "bash: command not found" after installing a package

bash copy
# Reload your shell configuration
source ~/.bashrc

# Or close and reopen Termux completely

Error: "CANNOT LINK EXECUTABLE" or library errors

bash copy
# Fix: Full upgrade of all packages
pkg update && pkg upgrade -y

Error: Storage permission denied

bash copy
# Fix: Re-run storage setup
termux-setup-storage

Then tap Allow when the Android permission dialog appears.

Termux is Very Slow or Freezing

This is usually caused by running too many sessions simultaneously or a package process hanging. Swipe right to open the sessions panel and close unused sessions. You can also kill all background jobs with:

bash copy
kill %1 %2 %3

// 08 — Pro Tips for Getting the Most Out of Termux

💡
Tip 1 — Use Multiple Sessions: Swipe right from the left edge of the Termux screen to open the sessions panel. You can run multiple independent terminal sessions simultaneously — great for running a script in one tab while working in another.
💡
Tip 2 — Use tmux for Persistent Sessions: Install tmux (pkg install tmux) to run sessions that survive even if you close the Termux app. Your processes keep running in the background.
💡
Tip 3 — Connect a Bluetooth Keyboard: Termux becomes dramatically more productive with a physical keyboard. Pair any Bluetooth keyboard with your Android device and you'll have a near-laptop experience.
💡
Tip 4 — Use aliases for Long Commands: Add short aliases for commands you type often. Edit ~/.bashrc and add lines like alias update='pkg update && pkg upgrade -y'. Now just typing update runs the full command.
💡
Tip 5 — Back Up Your Termux Setup: Back up your home directory to your phone's storage regularly: cp -r ~ ~/storage/shared/termux-backup. If anything breaks, you can restore your scripts, configs, and projects.
💡
Tip 6 — Learn Tab Completion: Press the Tab key while typing a command or file name to autocomplete it. Double-tap Tab to see all possible completions. This single habit will make you dramatically faster in any terminal.

// 09 — Termux Package Managers Compared

Termux supports several ways to install software. Here's how they compare:

Method Command Best For Notes
pkg pkg install Most tools and languages Termux's main package manager — use this first
apt apt install Same as pkg pkg is a wrapper for apt; both work the same
pip pip install Python libraries Requires Python to be installed first
npm npm install Node.js packages Requires Node.js to be installed first
gem gem install Ruby gems Requires Ruby to be installed first
cargo cargo install Rust crates/tools Requires Rust; compiles from source (slower)
git clone git clone URL GitHub tools/scripts Good for tools not in official repos

// FAQ — Frequently Asked Questions About Termux Setup

Do I need to root my Android phone to use Termux?
Absolutely not. Termux is one of the most powerful Linux environments for Android and it requires zero root access. It works entirely within Android's app sandbox using the device's Linux kernel. Everything in this guide works on any non-rooted Android phone running Android 7 or newer.
Why shouldn't I install Termux from the Google Play Store?
The Google Play Store version of Termux was officially abandoned by the developers due to Google's policies restricting what apps can execute. It no longer receives updates, its package repositories are outdated, and many packages will fail to install or function. Always install from F-Droid or the official GitHub releases.
How much storage does a full Termux setup take?
A fresh Termux install with the base environment is around 100–150 MB. Once you start installing packages, it grows. A typical setup with Python, Node.js, git, and a few tools might use 500 MB to 1 GB. Installing a full Linux distro (like Ubuntu via proot) can use 2–3 GB or more.
Can I run Termux in the background?
Yes. Termux can run in the background — swipe it away rather than force-stopping it and your processes will continue. For more reliable background operation, install tmux (pkg install tmux) which keeps sessions alive even through app restarts. Also make sure Android's battery optimization is disabled for Termux in your phone settings.
What Android version do I need to run Termux?
Termux officially requires Android 7.0 (Nougat) or higher. However, for the best experience — especially with newer package versions — Android 9.0 or higher is recommended. Most modern Android phones from 2019 onwards will work perfectly with everything in this guide.
Is Termux safe to use?
Yes, Termux itself is completely safe. It's a legitimate open-source app used by millions of developers and students worldwide. Like any powerful tool, it should be used responsibly. Avoid running scripts or commands from untrusted sources without understanding what they do. Stick to official repositories and trusted GitHub projects.
Can Termux damage my phone?
On a non-rooted device, Termux cannot modify core Android system files, so the risk of damaging your phone is extremely low. However, you can delete your own Termux files by accident with commands like rm -rf, so always be careful with deletion commands. When in doubt, make backups.

// 10 — Conclusion: Your Termux Journey Starts Now

You now have everything you need to set up and use Termux like a pro in 2026. From installing it correctly via F-Droid, to running your first commands, setting up Python and Git, navigating the file system, customizing your terminal, and fixing common errors — this complete Termux setup guide has covered it all, from start to finish, with no root required.

Termux is genuinely one of the most remarkable pieces of software available on Android. It transforms your phone into a capable Linux workstation that fits in your pocket. The skills you learn in Termux — Linux commands, scripting, networking concepts, version control — are real, transferable skills that apply to full desktop Linux, server administration, and development careers.

The best resource for continuing your Termux learning journey is right here at hydratermux.blogspot.com, where you'll find in-depth tutorials on everything from installing specific tools to learning cybersecurity concepts in a structured, beginner-friendly way. Bookmark it and come back often.

Now open Termux, run pkg update && pkg upgrade, and start exploring. The terminal is yours. What will you build?

You're all set! Share this guide with a friend who wants to get started with Termux. And drop a comment below — what was the first thing you installed after reading this guide?

Rixon Xavier

Founder — HYDRA TERMUX

Cybersecurity educator and Termux enthusiast. Creating free tutorials to help Android users learn Linux and ethical cybersecurity since 2023.

⚠️ Disclaimer: This tutorial is for educational purposes only. Always practice on systems you own or have explicit permission to test. HYDRA TERMUX does not support illegal activity of any kind.
--- BLOGGER SETTINGS FOR THIS POST: Title: Complete Termux Setup Guide for Beginners 2026 — Everything in One Place Labels: termux, linux, android, Termux Tutorial, No Root, android tools, coding, terminal Search Description: Complete Termux setup guide for beginners 2026. Install Termux from F-Droid, configure packages, navigate files & customize your terminal. No root required. Custom Robot Tags: all, noodp ---
Next Post Previous Post
No Comments Yet
Add Comment
comment url