How To Upgrade Python In Linux : Using Pip Install Method

by

Upgrading Python in Linux means you are replacing the existing Python binary with a newer version from a trusted source. If you’ve ever wondered how to upgrade python in linux, you’re not alone—it’s a common task for developers and system administrators. Python updates bring security patches, new features, and performance improvements, so staying current is important. This guide will walk you through the entire process step by step, covering multiple Linux distributions and methods.

How To Upgrade Python In Linux

Before you start, you need to understand that Python is deeply integrated into many Linux systems. Upgrading the default system Python can break critical tools like package managers or desktop environments. That’s why you should never replace the system Python directly. Instead, you’ll install a newer version alongside the existing one and manage them carefully.

This article covers three main approaches: using your distribution’s package manager, compiling from source, and using tools like pyenv. Each method has its pros and cons, and I’ll help you choose the right one for your needs.

Check Your Current Python Version

First, let’s see what Python version you’re currently running. Open your terminal and type:

python3 --version

Or just:

python --version

Most modern Linux systems have Python 3 pre-installed. You might see something like “Python 3.8.10” or “Python 3.10.12”. Write this down so you know what you’re upgrading from.

Also check if Python 2 is installed (though it’s deprecated):

python2 --version

Knowing your starting point helps you avoid confusion later.

Method 1: Upgrade Python Using APT (Debian/Ubuntu)

If you’re on Debian, Ubuntu, or any Debian-based distro, the easiest way is through APT. But here’s the catch: APT repositories often don’t have the absolute latest Python version. They focus on stability, so you might get a version that’s a few months old.

First, update your package list:

sudo apt update

Then upgrade existing Python packages:

sudo apt upgrade python3

To install a specific newer version, search for available packages:

apt list --all-versions python3

If you see a newer version listed, install it directly:

sudo apt install python3.11

Replace “3.11” with whatever version you want. After installation, you can run Python 3.11 specifically with:

python3.11

To make it the default python3 command, you’d need to update the alternatives system, but I’ll cover that later.

Adding DeadSnakes PPA (Ubuntu)

For Ubuntu users who want newer Python versions not in the official repos, the DeadSnakes PPA is a lifesaver. It provides multiple Python versions that are easy to install.

Add the PPA:

sudo add-apt-repository ppa:deadsnakes/ppa

Update your package list:

sudo apt update

Now install the Python version you want:

sudo apt install python3.12

This method is safe and doesn’t mess with your system Python. You’ll have both versions available.

Method 2: Upgrade Python Using YUM/DNF (RHEL/CentOS/Fedora)

For Red Hat-based systems like CentOS, RHEL, or Fedora, the process is similar but uses different commands.

On Fedora, which uses DNF, you can search for available Python versions:

dnf search python3

Then install a specific version:

sudo dnf install python3.11

On older CentOS 7 or RHEL 7, you’ll use YUM. But these systems often have older Python versions in their repos. For newer versions, you might need to enable EPEL or use Software Collections (SCL).

For CentOS 8 and RHEL 8, DNF is the default. You can install multiple Python versions side by side:

sudo dnf install python3.11 python3.11-devel

Fedora usually has very recent Python versions, so you might not need to upgrade at all. Check with dnf list installed python3.

Method 3: Compile Python From Source

If you need the absolute latest Python version or want custom build options, compiling from source is the way to go. This method gives you full control but takes more time and effort.

First, install the build dependencies:

sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev wget

For Fedora/RHEL:

sudo dnf groupinstall "Development Tools"
sudo dnf install openssl-devel bzip2-devel libffi-devel

Now download the Python source code from the official website. Go to python.org and copy the link for the version you want. Then use wget:

wget https://www.python.org/ftp/python/3.12.0/Python-3.12.0.tgz

Extract the tarball:

tar -xf Python-3.12.0.tgz
cd Python-3.12.0

Configure the build. The --enable-optimizations flag makes Python run faster but takes longer to compile:

./configure --enable-optimizations

Compile using multiple cores to speed things up:

make -j $(nproc)

Finally, install it. Use altinstall instead of install to avoid overwriting the system Python:

sudo make altinstall

This installs Python as python3.12 (or whatever version you compiled), leaving your system Python untouched.

Method 4: Use Pyenv To Manage Multiple Python Versions

Pyenv is a fantastic tool for managing multiple Python versions without touching your system Python. It’s perfect if you need to switch between versions frequently or test your code across different Python releases.

First, install pyenv dependencies:

sudo apt update
sudo apt install curl git build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

For Fedora:

sudo dnf install git curl gcc make patch zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel tk-devel libffi-devel xz-devel

Install pyenv using the installer script:

curl https://pyenv.run | bash

After installation, add pyenv to your shell configuration. Add these lines to your ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

Restart your shell or run source ~/.bashrc.

Now you can list available Python versions:

pyenv install --list

Install a specific version:

pyenv install 3.12.0

Set it as the global default (for your user):

pyenv global 3.12.0

Or set it only for a specific project directory:

cd my_project
pyenv local 3.12.0

Pyenv makes upgrading and switching Python versions incredibly easy.

Set The Default Python Version (Alternatives System)

If you’ve installed a new Python version and want the python3 command to point to it, you can use the update-alternatives system on Debian/Ubuntu. But be careful—changing the default can break system tools.

First, register the new Python version:

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1

Then configure which version to use:

sudo update-alternatives --config python3

You’ll see a list of installed versions. Select the one you want.

On Fedora/RHEL, you can use the alternatives command similarly:

sudo alternatives --set python3 /usr/bin/python3.11

Again, I strongly recommend not changing the system default. Use pyenv or explicit version commands instead.

Verify The Upgrade

After upgrading, always verify that the new version works correctly:

python3 --version

Also test that pip is updated:

pip3 --version

If pip is missing or outdated, install it:

python3 -m ensurepip --upgrade

Or for the new version specifically:

python3.12 -m ensurepip --upgrade

Create a simple test script to confirm everything runs:

python3 -c "print('Python upgrade successful!')"

Common Issues And Fixes

Upgrading Python isn’t always smooth. Here are some common problems you might encounter.

Missing SSL module: When compiling from source, you might get an SSL error. This usually means you didn’t install the OpenSSL development headers. Install them and recompile.

Pip not found: After installing a new Python version, pip might not be available. Run python3.x -m ensurepip to install it.

Broken system tools: If you replaced the system Python, tools like apt or yum might break. Restore the original version using your package manager.

Permission denied: When installing globally, always use sudo or install for your user only with --user flag.

Virtual environments break: If you upgrade Python, existing virtual environments might not work. Create new ones with the new version.

Best Practices For Python Upgrades

To keep your system stable and your development smooth, follow these guidelines.

  • Never replace the system Python. Install new versions alongside it.
  • Use virtual environments for each project to isolate dependencies.
  • Test your code with the new Python version before switching completely.
  • Keep your package manager updated to avoid conflicts.
  • Document which Python version each project uses.
  • Use pyenv or conda for managing multiple versions easily.
  • Always backup important data before major upgrades.

Upgrading Python On Different Distributions

Here’s a quick reference for specific distributions.

Ubuntu/Debian: Use APT with DeadSnakes PPA for newer versions. Avoid changing system Python.

Fedora: Usually has recent Python. Use DNF to install additional versions.

CentOS/RHEL: Use EPEL or compile from source. Software Collections (SCL) also works on older versions.

Arch Linux: Python is often very recent. Use pacman -S python to upgrade.

openSUSE: Use Zypper to install multiple versions.

Alpine Linux: Use apk add python3 but note that Alpine uses musl libc, which can cause compatibility issues.

Why Upgrade Python?

You might wonder if upgrading is worth the hassle. Here are the main reasons.

  • Security patches: Older versions have known vulnerabilities.
  • New features: Each release adds performance improvements and syntax enhancements.
  • Library support: Many Python libraries drop support for older versions.
  • Compatibility: Some tools require a minimum Python version.
  • Performance: Newer versions are often faster and more memory-efficient.

For example, Python 3.11 is significantly faster than Python 3.8, and Python 3.12 introduces improved error messages.

Downgrading Python If Something Goes Wrong

If an upgrade causes issues, you can revert. If you installed a new version alongside the old one, simply remove the new version:

sudo apt remove python3.12

Or if you used pyenv:

pyenv uninstall 3.12.0

If you accidentally replaced the system Python, reinstall it from your package manager:

sudo apt install --reinstall python3

This should restore the original version.

Automating Python Upgrades

If you manage multiple servers, consider automating upgrades with scripts. Here’s a simple bash script for Ubuntu:

#!/bin/bash
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt install python3.12 -y
python3.12 --version

For pyenv users, you can automate installation of the latest stable version:

pyenv install $(pyenv install --list | grep -E '^\s*3\.' | tail -1 | tr -d ' ')

This picks the latest Python 3.x version available.

Frequently Asked Questions

Q: How do I upgrade Python in Linux without breaking my system?

Always install the new version alongside the existing one. Use tools like pyenv or compile with make altinstall. Never replace the default system Python binary.

Q: Can I upgrade Python using pip?

No, pip is for Python packages, not the Python interpreter itself. You need to use your system package manager, compile from source, or use pyenv.

Q: What’s the safest way to upgrade Python in Linux?

Using pyenv is the safest method because it keeps your system Python untouched and allows easy version switching. It also handles dependencies well.

Q: How do I upgrade Python in Linux to the latest version?

Compile from source or use pyenv to get the absolute latest. For Ubuntu, the DeadSnakes PPA often has recent versions. Check Python.org for the latest release.

Q: Why does my Linux system have Python 2 and Python 3?

Some older system tools still rely on Python 2. Python 3 is the modern version. You should upgrade to Python 3 for all new development.

Q: How do I upgrade pip after upgrading Python?

Run python3.x -m pip install --upgrade pip where 3.x is your new Python version. This ensures pip matches your Python version.

Conclusion

Upgrading Python in Linux is a straightforward process when you use the right approach. Whether you choose APT, compile from source, or use pyenv, the key is to avoid touching the system Python. I recommend pyenv for most users because of its flexibility and safety. For quick upgrades on Ubuntu, the DeadSnakes PPA works great. Always test your applications after upgrading to catch any compatibility issues early. With this guide, you now have multiple ways to keep your Python installation up to date. Happy coding, and remember to check for updates regularly.