When working with Node.js and its robust ecosystem of libraries and packages, it is common to encounter error messages. One such error that often perplexes developers is “error:0308010C:digital envelope routines::unsupported.”
This error usually shows up when working with OpenSSL and cryptography libraries in Node.js, particularly when using packages like React.js. This article provides an integrated guide to both understanding and resolving this issue.
WordPress new versions have included these JS libraries in the core so might be you can encounter this common error.
Understanding the “error:0308010C:digital envelope routines::unsupported”
The error message originates from OpenSSL, an open-source software library that applications use for secure communication over computer networks.
The message implies that a part of OpenSSL you're trying to use is unsupported. This issue typically stems from version incompatibilities between OpenSSL and Node.js.
Here is a guide on How to Easily add SSL and move WordPress from HTTP to HTTPS
Fix “error:0308010C:digital envelope routines::unsupported”
To handle this error, follow these systematic steps:
1. Identify the Node.js and OpenSSL Version
Check your Node.js version using this command:
To see the OpenSSL version, use:
node -p "process.versions.openssl"
These commands will display the Node.js and OpenSSL versions you're using, respectively.
2. Investigate Compatibility Issues
Check if there are known compatibility issues between the Node.js version you're using and the required OpenSSL version.
An older version of Node.js might come with an OpenSSL version that doesn't support certain features needed by your application, or vice versa.
3. Upgrade or Downgrade Node.js
If you discover that your Node.js version is incompatible with the OpenSSL version required by your software, you may need to upgrade or downgrade Node.js.
Use a Node Version Manager tool like NVM to install or use a specific version:
nvm install <version> nvm use <version>
<version> with the version number, you wish to install or use.
4. Use the –openssl-legacy-provider Flag
As a temporary fix, modify the
start script in your
package.json file from:
"start": "react-scripts start"
"start": "react-scripts --openssl-legacy-provider start"
This command instructs Node.js to use OpenSSL's legacy provider when starting your application. It's a quick fix but should be used with caution, as it might lead to insecure SSL usage.
5. Reinstall Packages
After changing Node.js versions or using the
--openssl-legacy-provider flag, ensure you remove the
node_modules directory and the
package-lock.json file, then reinstall your packages:
rm -rf node_modules rm package-lock.json npm install
6. Consult Node.js Community
If none of the above steps resolves the issue, seek help from the Node.js community on forums like Stack Overflow, GitHub, or the official Node.js community.
When asking questions, provide detailed information about the issue, including the exact error message, Node.js and OpenSSL versions, and what you've done so far to resolve the issue.
You might also be interested in:
Although error messages like “error:0308010C:digital envelope routines::unsupported” may seem daunting, they often boil down to versioning or compatibility issues.
Carefully check your Node.js and OpenSSL versions, and make the necessary adjustments to resolve the issue. If all else fails, remember that the Node.js community is a resourceful place to seek help.
Despite temporary fixes like using the
--openssl-legacy-provider flag, keep in mind that such solutions may lead to potential security issues, especially in a production environment.
Always aim to fix the underlying problem and ensure the security of your applications.
As one of the co-founders of Codeless, I bring to the table expertise in developing WordPress and web applications, as well as a track record of effectively managing hosting and servers. My passion for acquiring knowledge and my enthusiasm for constructing and testing novel technologies drive me to constantly innovate and improve.
Linux System Administration,
15 years of experience in Web Development by developing and designing some of the most popular WordPress Themes like Specular, Tower, and Folie.
I have a degree in Engineering Physics and MSC in Material Science and Opto Electronics.