From 879effb1ccccddf569d63e33894bbb2af308ea2f Mon Sep 17 00:00:00 2001 From: Alicia Sykes Date: Sun, 10 Sep 2023 16:26:15 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Adds=20Unsupported=20Digital=20E?= =?UTF-8?q?nvelope=20Routines=20to=20troubleshooting.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/troubleshooting.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 6ea317a3..76fa5114 100644 --- a/docs/troubleshooting.md +++ b/docs/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.