GLIBC_2.xx not found 🐧 Linux

/lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found

The binary was built on a newer Linux than the one you run it on, and needs a newer glibc than your system has.

Seen on: Linux

Meaning

glibc is backward- but not forward-compatible. Binaries built on Ubuntu 22.04 (glibc 2.35) won’t run on CentOS 7 (2.17) or Ubuntu 20.04 (2.31). Common with downloaded tools, Node native modules and prebuilt wheels.

Common causes

  • Binary built on a newer distro
  • Prebuilt native module/wheel for a newer glibc
  • Old OS (CentOS 7, Ubuntu 18.04)

⚡ Quick fix

  1. Download a build for older glibc or a static/musl build
  2. Build from source on the target system
  3. Upgrade the OS or run in a container with a newer base

Detailed fix by platform

Linux

  1. bash
    ldd --version | head -1
objdump -T ./app | grep -o 'GLIBC_[0-9.]*' | sort -Vu | tail -3

How to diagnose

  1. System — ldd --version
  2. Required — Highest GLIBC_ in the binary

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.