How to Fix the Error: error:0308010C:digital envelope routines::unsupported in Node.js

In this post we cover how to Fix the Error: error:0308010C:digital envelope routines::unsupported in Node.js

When working with Node.js, you may encounter the following error related to digital envelope routines:

1Error: error:0308010C:digital envelope routines::unsupported
2    at new Hash (node:internal/crypto/hash:67:19)
3    at Object.createHash (node:crypto:130:10)
4    ...
5

This error typically arises due to an incompatibility between the version of Node.js you are using and certain cryptographic algorithms expected by libraries like Webpack. Here’s how to resolve this issue:

1. Update Node.js

First, ensure you are using a compatible version of Node.js. Some cryptographic methods are deprecated in the latest versions. It’s often helpful to downgrade to a version known to work with your dependencies.

Check Your Node.js Version

You can check your current Node.js version with:

1node -v

Downgrade Node.js (if necessary)

If you are using Node.js 17 or newer, try downgrading to a stable LTS version like Node.js 16:

1nvm install 16
2nvm use 16

2. Set Node.js Environment Variables

If you prefer to continue using your current Node.js version, you can set the environment variable to enable legacy OpenSSL providers.

Temporarily via Command Line

For a single session, you can set the environment variable directly in the command line:

1export NODE_OPTIONS=--openssl-legacy-provider

Permanently via Environment Configuration

Add the following line to your environment configuration file (.bashrc, .zshrc, or similar):

1export NODE_OPTIONS=--openssl-legacy-provider

Then, reload your shell configuration:

1source ~/.bashrc  # or source ~/.zshrc

3. Update Webpack Configuration

If updating Node.js or setting environment variables doesn’t resolve the issue, consider updating your Webpack configuration to ensure compatibility.

Modify Webpack Config

Ensure that the Webpack configuration uses supported hash functions:

1// webpack.config.js
2const crypto = require('crypto');
3
4module.exports = {
5  // Other configurations...
6  output: {
7    // Other output configurations...
8    hashFunction: 'sha256'  // Use a supported hash function
9  }
10};

4. Reinstall Dependencies

Sometimes, simply reinstalling the project dependencies can resolve mismatched versions that lead to such errors.

1rm -rf node_modules
2rm package-lock.json
3npm install
4

Conclusion

By downgrading Node.js, setting the appropriate environment variables, updating your Webpack configuration, or reinstalling dependencies, you should be able to resolve the error:0308010C:digital envelope routines::unsupported issue. These steps help ensure that your development environment is compatible with the cryptographic requirements of your project's dependencies.

For more detailed information, refer to the Node.js documentation and the Webpack documentation.

Node.js

Node.js is an open-source, cross-platform runtime environment that enables developers to run JavaScript code on the server side, outside of a web browser. Built on the V8 JavaScript engine from Google Chrome, Node.js allows for the creation of high-performance, scalable network applications. Its non-blocking, event-driven architecture makes it particularly suitable for real-time applications and services that require frequent updates, such as chat applications, gaming, and live streaming services.

Node.js is used for a variety of purposes, including building web servers, RESTful APIs, microservices, and server-side applications for the Internet of Things (IoT). Its extensive ecosystem of libraries and modules, managed through npm (Node Package Manager), provides tools and resources that simplify the development process and enhance functionality. This makes Node.js a popular choice for developers aiming to create modern, efficient, and scalable web applications.

Further resources

Node.js Docs

SoftwareShorts