Skip to content

Frequently Asked Questions

Jump to bottom Edit New page
Amitosh Swain Mahapatra edited this page Apr 21, 2025 · 1 revision

Before reporting an issue, please check this page for most common errors and their solutions.

Failed to install bcrypt

This can happen for a various reasons:

  1. You are running npm as root (EPERM)

  2. You are running npm on a read-only file system or a fs with '/tmp' being read-only (EACCESS)

  3. It's a new(untested) or unsupported release of NodeJS/npm and pre-built binaries are not available. (ERR:node-pre-gyp(404)). You need python and compilers as instructed in the installation instructions.

  4. You are in a offline environment that cannot reach Github. If your environment cannot reach the internet, installation will fail when node-pre-gyp cannot download the binaries from Github. One solution is to change the binary host with the following argument:

npm install bcrypt --bcrypt_lib_binary_host_mirror=https://INTERNAL_HOST/artifactory/node-pre-gyp-binaries

Installation with PNPM fails

pnpm v10+ blocks running build scripts by default, you need to add bcrypt to onlyBuiltDependencies in your package.json to allow building. See: https://pnpm.io/settings#onlybuiltdependencies

Add a custom footer
Add a custom sidebar
Clone this wiki locally