sharp module npm Origin: Build & delivery Last updated 12 Oct 2026

Error: Could not load the "sharp" module using the linux-x64 runtime

sharp’s native binary for this OS/CPU isn’t installed — usually node_modules installed on another platform (Mac → Linux/Docker).

Exact message you may see Could not load the "sharp" moduleSomething went wrong installing the "sharp" module
Explore the map of this error Full error map →
Seen on: npm

Meaning

sharp ships platform-specific binaries as optional dependencies. Copying node_modules between machines, or installing with --omit=optional, breaks it.

Common causes

  • node_modules copied from macOS into a Linux container
  • Optional dependencies skipped
  • Lockfile generated on another platform without that platform’s package

⚡ Quick fix

  1. Install inside the target environment (npm ci in Docker)
  2. Add .dockerignore for node_modules
  3. npm install --os=linux --cpu=x64 sharp when cross-installing

Detailed fix by platform

Docker

  1. bash
    # .dockerignore
node_modules

How to diagnose

  1. Platform — Where was node_modules installed?
  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):

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…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…invalid ELF header — Error: /app/node_modules/bcrypt/lib/binding/bcrypt_lib.node: invalid ELF header (npm)invalid ELF headerNo 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 modulesharp mod…

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.