Termux Genius

Home
Termux Tutorial

How to Update & Upgrade Packages in Termux (2026 Guide)

How to Update & Upgrade Packages in Termux: Simple Guide for 2026

Welcome to the world of Termux! This powerful app brings the magic of Linux to your phone. Just like your favorite apps need updates to work their best, Termux packages need regular updates too. In this friendly guide, we'll walk through how to update and upgrade packages in Termux using simple commands. By the end, you'll be confidently keeping your Termux environment fresh and working smoothly - even if you've never used a command line before!

Termux app interface showing the command line on a smartphone

Why Updating Packages in Termux Matters

Keeping your Termux packages updated is like making sure your toolbox has the latest and best tools. Here's why it's worth taking a few minutes to update regularly:

  • Get the newest features that make using Termux more fun and powerful
  • Fix bugs that might be causing crashes or strange behavior
  • Patch security holes that could put your information at risk
  • Make sure all your tools work well together
  • Prevent frustrating errors when trying to install new packages

    • Most Termux users make updating packages part of their regular routine - just like checking for app updates in the Play Store. The good news is that updating in Termux is quick and only requires two simple commands!

    Illustration showing the benefits of updating packages in Termux

    Getting Started: Opening Termux

    Before we can update any packages, we need to open Termux and access the command line. The command line is simply a text interface where you can type instructions for your phone to follow.

  • Find the Termux app icon on your home screen or in your app drawer
  • Tap on the Termux icon to open the app
  • Wait for Termux to load - you'll see a black screen with some text
  • You'll know Termux is ready when you see a dollar sign ($) at the bottom of the screen

    • Tip: If this is your first time opening Termux after installation, you might see some initial setup text. This is normal! Just wait for it to finish and show the $ prompt.

    Step-by-step visual guide showing how to open Termux on a smartphone

    That $ symbol is called a "prompt" - it's Termux's way of saying "I'm ready for your instructions!" Now we're all set to start updating packages.

    Step 1: Update Package Lists with pkg update

    The first command we need to run is pkg update. Think of this as Termux checking what's new in the store before actually downloading anything.

    pkg update

    When you type this command and press Enter, Termux will connect to its package repositories (online libraries of software) and check for any new information about available packages. It's like checking a menu before ordering food.

    Termux screen showing the pkg update command being executed

    What this command does: The pkg update command refreshes Termux's knowledge about what packages are available and what versions exist. It doesn't actually install anything yet - it just updates the lists.

    After running this command, you might see Termux ask for your permission to continue. This happens when it finds packages that can be updated. You'll see something like:

    Do you want to continue? [Y/n]

    Simply type Y (or just press Enter, which means "yes") to continue. Termux will then finish updating its package lists.

    Troubleshooting: If you see an error message about "repository is under maintenance or down," try again later or change to a different mirror. We'll cover how to change mirrors at the end of this guide.

    Step 2: Upgrade Installed Packages with pkg upgrade

    Now that Termux knows what's available, we can tell it to actually download and install the newer versions of packages. For this, we use the pkg upgrade command.

    pkg upgrade

    When you run this command, Termux will look at all the packages you have installed, compare them with the latest versions it just learned about, and update any that have newer versions available.

    Termux screen showing the pkg upgrade command being executed with packages being upgraded

    What this command does: The pkg upgrade command downloads and installs newer versions of packages you already have. It's like replacing your old tools with newer, better versions.

    During the upgrade process, Termux might ask you questions about certain packages. The most common one is:

    Configuration file 'filename' is modified, do you want to keep your current version? [Y/n]

    If you haven't manually changed any configuration files (which is likely if you're a beginner), just press Enter to keep the current version. If you're unsure, pressing Enter (accepting the default "Y") is usually the safest option.

    Important: Don't close Termux or turn off your screen while packages are upgrading. Let the process finish completely. You'll know it's done when you see the $ prompt again.

    Optional: Upgrading a Single Package

    Sometimes you might want to update just one specific package instead of everything. For example, if you just need to update Python but don't want to wait for everything else to update. Here's how to do that:

    pkg install -y package-name

    Replace "package-name" with the actual name of the package you want to update. For example, to update just Python, you would type:

    pkg install -y python

    Termux screen showing a single package being upgraded

    The -y flag automatically answers "yes" to the confirmation prompt, saving you an extra step. This command will both install the package if it's not already installed, or upgrade it to the latest version if you already have it.

    Tip: Not sure what a package is called? You can search for packages using pkg search keyword where "keyword" is what you're looking for.

    Troubleshooting Common Update Problems

    Sometimes updates don't go as smoothly as we'd like. Here are solutions to the most common problems you might encounter:

    Problem: "Repository is under maintenance or down"

    This means Termux can't reach the server where packages are stored. The solution is to change to a different mirror (an alternative server with the same packages).

    Run this command to change mirrors:

    termux-change-repo

    Use the arrow keys to navigate, space to select, and enter to confirm your choice. Try selecting a different mirror, like "Mirrors by BFSU" or "Mirrors by TUNA".

    Problem: "dpkg: error processing package..."

    This usually means a package update was interrupted. Try running:

    dpkg --configure -a

    Then run pkg update and pkg upgrade again.

    Problem: "Can't locate package..."

    This means either the package name is misspelled or your package lists are very outdated. Make sure you've run pkg update first, then check the spelling of the package name.

    Illustration showing common Termux update errors and their solutions

    Important note: If you installed Termux from Google Play Store, you might experience package command errors because Play Store builds are no longer supported. It's recommended to install Termux from F-Droid or GitHub releases instead.

    Best Practices for Keeping Termux Updated

    To keep your Termux experience smooth and trouble-free, here are some helpful habits to develop:

    Update Regularly

    Run pkg update and pkg upgrade about once a week to keep everything fresh. This prevents a buildup of many updates that could cause conflicts.

    Update Before Installing

    Always run pkg update before trying to install any new package. This ensures you're installing the latest version compatible with your other packages.

    Check Connection First

    Make sure you have a stable internet connection before starting updates, especially for large upgrades. Wi-Fi is preferable to mobile data.

    Keep Screen On

    Change your phone settings to keep the screen on longer when updating large packages, or tap the screen occasionally to prevent it from sleeping.

    Save Your Commands

    Keep a note with useful commands so you don't have to remember them. Termux also has command history - press the up arrow to see previous commands.

    Learn One New Thing

    Each time you use Termux, try to learn one new command or feature. Over time, you'll become very comfortable with it!

    Person using Termux on a smartphone with good practices illustrated

    What to Explore Next in Termux

    Now that you know how to keep your Termux environment updated, here are some exciting things you might want to try next:

    Collage showing different possibilities with Termux

      Programming

    • Install Python with pkg install python
    • Try Node.js with pkg install nodejs
    • Learn Bash scripting right in Termux
    • Create your first programs on your phone

      Useful Tools

    • Text editors like Nano or Vim
    • File managers for easier navigation
    • Download tools like wget or curl
    • SSH to connect to other computers

      Fun Projects

    • Run a simple web server
    • Create a personal diary with text files
    • Learn to use Git for your projects
    • Try simple games like Nethack

    Ready to Take Your Termux Skills Further?

    Termux opens up a world of possibilities right on your phone. With the update and upgrade commands you've learned, you'll always have the latest tools at your fingertips. Start small, be patient with yourself, and soon you'll be doing amazing things with just a few taps!

    Explore the Termux Wiki

    Conclusion: You're Now Ready to Keep Termux Updated!

    Congratulations! You now know how to keep your Termux packages fresh and up-to-date. Let's quickly recap what we've learned:

  • Use pkg update to refresh package information
  • Use pkg upgrade to install newer versions of packages
  • For a single package, use pkg install -y package-name
  • If you encounter problems, try changing mirrors with termux-change-repo

    • Remember, keeping your packages updated is one of the simplest yet most important habits for a smooth Termux experience. By taking a minute to run these commands regularly, you'll avoid many common problems and always have the best tools available.

    The command line might seem strange at first, but with each small success, you'll build confidence. Before long, you'll be typing commands like a pro and exploring all the amazing things Termux can do!

    Successful update and upgrade process completed in Termux

    Happy exploring in the wonderful world of Termux!