Skip to main content

How to Resolve Python "Configure error: no acceptable C compiler found in $PATH"

When compiling software from source or installing certain Python packages (especially those with C extensions) on Linux or macOS systems, you might encounter the error configure: error: no acceptable C compiler found in $PATH. This error indicates that the build process cannot locate a functioning C compiler (typically GCC or Clang) in the directories specified by your system's PATH environment variable.

This guide explains why a C compiler is needed and provides the standard commands to install the necessary build tools on various Linux distributions.

Understanding the Error: The Role of the C Compiler and PATH​

Many software programs, including components of Python libraries, are written fully or partially in the C programming language. To turn this human-readable C source code into executable machine code, a C compiler (like GCC - GNU Compiler Collection, or Clang) is required.

Build systems (often using scripts named configure or tools like make) automate the compilation process. The configure script typically checks your system for necessary tools, including a C compiler. It searches for the compiler executable (e.g., gcc) in the directories listed in your system's PATH environment variable.

The error no acceptable C compiler found in $PATH means the configure script searched all directories in your PATH but couldn't find a suitable C compiler executable.

The Cause: Missing Compiler or Incorrect PATH​

There are two primary reasons for this error:

  1. No C Compiler Installed: Your system simply doesn't have GCC, Clang, or another standard C compiler installed. This is common on minimal OS installations.
  2. Compiler Not in PATH: A C compiler might be installed, but its location is not included in the PATH variable, so the system cannot find it when searching standard locations. (This is less common with standard package manager installations).

Solution: Install C Compiler / Build Tools (Distribution Specific)​

The most common solution is to install the necessary compiler and related build tools using your distribution's package manager. These often come bundled in convenient meta-packages or groups.

note

You will likely need administrative privileges (root or sudo) to run these installation commands.

Debian / Ubuntu / Mint (build-essential)​

This package group installs GCC, G++, make, and essential libraries.

# 1. Update package lists (recommended)
sudo apt update

# 2. Install the build tools
sudo apt install build-essential -y
note

The -y flag automatically confirms the installation

RHEL / CentOS / Fedora (Development Tools, gcc)​

This group installs GCC, G++, make, automake, and other core development utilities.

# 1. Install the Development Tools group
sudo yum groupinstall "Development Tools" -y
# Or if using dnf (newer Fedora/RHEL):
# sudo dnf groupinstall "Development Tools" -y

# 2. Ensure gcc is explicitly installed (often included, but good to check)
sudo yum install gcc -y
# Or: sudo dnf install gcc -y
  • If the error persists (especially on older CentOS/RHEL): Sometimes specific dependencies might still be missing. Try installing: 
    sudo yum install gcc glibc glibc-common gd gd-devel -y
    # Or: sudo dnf install gcc glibc glibc-common gd gd-devel -y

openSUSE (devel_basis)​

Use the zypper package manager to install the basic development pattern.

sudo zypper install --type pattern devel_basis

Alpine Linux (build-base, gcc)​

Alpine uses apk. The build-base package includes common tools.

# Install the basic build tools meta-package
apk add build-base

# If error persists, explicitly install compilers and make
# apk update # Ensure index is up-to-date first
# apk add gcc make g++ libc-dev # libc-dev might replace glibc-common
note

Alpine is minimal; sometimes more specific dependencies might be needed depending on what you're building

Arch Linux (base-devel)​

Arch uses pacman. The base-devel group contains essential build tools.

sudo pacman -Syu # Update system first (recommended)
sudo pacman -S base-devel --needed
note

--needed prevents reinstalling packages that are already up-to-date.

Verification: Checking the Compiler Installation​

After installing the appropriate package(s) for your distribution, verify that the C compiler (gcc is common) is installed and accessible via your PATH:

gcc --version

If the command successfully prints the GCC version information (e.g., gcc (Ubuntu 11.3.0-1ubuntu1~22.04) 11.3.0), the compiler is installed and likely configured correctly in your PATH. You can now retry the original ./configure or installation command that produced the error.

If you still get "command not found", double-check the installation steps for your distribution or investigate potential issues with your PATH environment variable (though standard package installations usually handle this).

Special Case: Shared Hosting Environments​

If you are using a shared web hosting environment, you typically do not have sudo or package management (apt, yum) privileges.

  1. Try running gcc --version.
  2. If you get Command not found, a C compiler is likely unavailable.
  3. If you get Permission denied, a compiler might be installed, but your user account doesn't have permission to execute it.

In either case on shared hosting, you must contact your hosting provider's support team. Explain that you need to compile software (mentioning the specific package or source if possible) and ask them if a C compiler is available and if they can grant your user the necessary permissions (sometimes called adding the user to a "compiler group" or similar). They might have specific procedures or limitations for compiling software on their platform.

Conclusion​

The configure: error: no acceptable C compiler found in $PATH means the build process requires a C compiler (like gcc) but cannot find one in the system's executable search path.

The solution is almost always to install the standard C compiler and build tools package for your specific Linux distribution:

  • Debian/Ubuntu: sudo apt install build-essential
  • RHEL/CentOS/Fedora: sudo yum/dnf groupinstall "Development Tools"
  • openSUSE: sudo zypper install --type pattern devel_basis
  • Alpine: apk add build-base
  • Arch: sudo pacman -S base-devel

After installation, verify with gcc --version and retry the original operation. If on shared hosting, contact your provider for assistance.

Table of Contents