invalid ELF header npm Origin: Build & delivery OSI layer 7 · Application Last updated 11 Oct 2026

Error: /app/node_modules/bcrypt/lib/binding/bcrypt_lib.node: invalid ELF header

A native module compiled for macOS/Windows is being loaded on Linux.

Exact message you may see invalid ELF headerwrong ELF class
Seen on: npm

Meaning

.node binaries are platform-specific. Copying node_modules into a Docker image or server from another OS causes it.

Common causes

  • node_modules copied from the host into the container
  • Shared volume between host and container

⚡ Quick fix

  1. Exclude node_modules via .dockerignore and run npm ci in the image
  2. Rebuild: npm rebuild

Detailed fix by platform

Docker

  1. bash
    COPY package*.json ./
    RUN npm ci
    COPY . .

How to diagnose

  1. Build — Where was node_modules created?
  2. Recent change — Did it start after a deploy, upgrade, or configuration change? Compare with the last working version.

🔧 Still not fixed?

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

Where this error sits

Origin: Build & delivery. Errors that are often confused with or caused by this one (click to open):

'sharp' is required to be installed in standalone mode — Next.js: Error: 'sharp' is required to be installed in standalone mode for the image optimization to function correctly (Next.js)'sharp' is required t…data directory permissions — FATAL: data directory "/var/lib/postgresql/data" has invalid permissions — Permissions should be u=rwx (0700) or u=rwx,g=rx (0750). (PostgreSQL)data directory permis…Docker Desktop requires privileged access (vmnetd) — macOS: Docker Desktop needs privileged access / com.docker.vmnetd could not be started (macOS)Docker Desktop requir…esbuild wrong platform — You installed esbuild for another platform than the one you're currently using. (npm)esbuild wrong platformgyp ERR! — gyp ERR! build error / node-gyp rebuild failed (npm)gyp ERR!incompatible data directory — FATAL: database files are incompatible with server — The data directory was initialized by PostgreSQL version 15, which is not compatible with this version 16 (PostgreSQL)incompatible data dir…No Xcode or CLT — gyp: No Xcode or CLT version detected! (npm)No Xcode or CLTrollup native module — Error: Cannot find module @rollup/rollup-linux-x64-gnu. npm has a bug related to optional dependencies (npm)rollup native moduleinvalid E…

Explore the map of this error Full error map →

🧠 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.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.