native addon
A Node.js package that includes compiled C or C++ code, such as some image or database libraries.
In more detail
They only run where Node.js APIs are available and must match the CPU architecture and C library of the machine. That matters when building Docker images on Alpine, which uses musl instead of glibc.
Related terms
- Node.js runtime — The default Next.js runtime, where server code runs on Node.js with access to every Node API and npm package.
- Edge runtime — A lightweight Next.js runtime based on V8 isolates and standard Web APIs, which starts almost instantly but cannot use most Node.js APIs.
- Alpine Linux — A very small Linux distribution often used as a base image because it is only a few megabytes.
Taught in
- Runtime Environments: Node.js vs Edge Runtime Choice — Next.js 15 & Modern App Router Architecture