diff --git a/troubleshooting.md b/troubleshooting.md index 6ea317a..76fa511 100644 --- a/troubleshooting.md +++ b/troubleshooting.md @@ -37,6 +37,7 @@ - [Widget Displaying Inaccurate Data](#widget-displaying-inaccurate-data) - [Font Awesome Icons not Displaying](#font-awesome-icons-not-displaying) - [Copy to Clipboard not Working](#copy-to-clipboard-not-working) +- [Unsupported Digital Envelope Routines](#unsupported-digital-envelope-routines) - [How to Reset Local Settings](#how-to-reset-local-settings) - [How to make a bug report](#how-to-make-a-bug-report) - [How-To Open Browser Console](#how-to-open-browser-console) @@ -525,6 +526,20 @@ As a workaround, you could either: --- +## Unsupported Digital Envelope Routines + +If you're running on GitHub Codespaces, and seeing: `Error: error:0308010C:digital envelope routines::unsupported` when using Node 17+, it can be resolved by adding the `--openssl-legacy-provider` flag to your `NODE_OPTIONS` environmental variable. +For example: + +``` +export NODE_OPTIONS=--openssl-legacy-provider +``` + +For more info, see [webpack/webpack#14532](https://github.com/webpack/webpack/issues/14532) and [nodejs/node#40455](https://github.com/nodejs/node/issues/40455). +This occours because [Node 17+](https://medium.com/the-node-js-collection/node-js-17-is-here-8dba1e14e382) no longer supports MD4 as hash function, we're in the process of upgrading Dashy dependencies to all use SHA1 for hashing bundle IDs. + +--- + ## How to Reset Local Settings Some settings are stored locally, in the browser's storage.