Software⏱️ 2 min read📅 2026-06-03

How to Fix: Node.js 17.0.1 Gatsby error - "digital envelope routines::unsupported ... ERR_OSSL_EVP_UNSUPPORTED"

Quick Answer: Try downgrading Node.js to v16, or update the OpenSSL library used by Gatsby. You can do this by running `npm install --save-dev openssl@1.x` in your project directory.

The error "digital envelope routines::unsupported ERR_OSSL_EVP_UNSUPPORTED" in Node.js 17.0.1 with Gatsby is often caused by an incompatibility between the version of OpenSSL used by Node.js and the version required by Gatsby's build process.

🛑 Root Causes of the Error

  • Node.js 17.0.1 uses a newer version of OpenSSL that is not compatible with Gatsby's build process.

🛠️ Step-by-Step Verified Fixes

Method 1: Downgrade Node.js to a Compatible Version

  1. Step 1: Install an older version of Node.js that is compatible with Gatsby, such as Node.js 16.

Method 2: Update OpenSSL to a Compatible Version

  1. Step 1: Run the command `npm install --force node-gyp` and then `node -v` to check if the OpenSSL version has been updated.

✨ Wrapping Up

By following one of these methods, you should be able to resolve the "digital envelope routines::unsupported ERR_OSSL_EVP_UNSUPPORTED" error in Node.js 17.0.1 with Gatsby.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions