Skip to content

Commit

Permalink
quickstart: document a known failure case and workaround
Browse files Browse the repository at this point in the history
  • Loading branch information
moio authored and richard-cox committed Jul 26, 2024
1 parent f6bf080 commit ec6829f
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions docusaurus/docs/internal/getting-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,3 +26,37 @@ API=https://your-rancher yarn dev

> Note: `API` is the URL of a deployed Rancher environment (backend API)
## Troubleshooting

If `yarn dev` fails with the following error:

```
Error: error:0308010C:digital envelope routines::unsupported
at new Hash (node:internal/crypto/hash:71:19)
at Object.createHash (node:crypto:130:10)
at module.exports (/Users/SMOIOLI/synced/repos/dashboard/node_modules/webpack/lib/util/createHash.js:135:53)
at NormalModule._initBuildHash (/Users/SMOIOLI/synced/repos/dashboard/node_modules/webpack/lib/NormalModule.js:417:16)
at handleParseError (/Users/SMOIOLI/synced/repos/dashboard/node_modules/webpack/lib/NormalModule.js:471:10)
at /Users/SMOIOLI/synced/repos/dashboard/node_modules/webpack/lib/NormalModule.js:503:5
at /Users/SMOIOLI/synced/repos/dashboard/node_modules/webpack/lib/NormalModule.js:358:12
at /Users/SMOIOLI/synced/repos/dashboard/node_modules/loader-runner/lib/LoaderRunner.js:373:3
at iterateNormalLoaders (/Users/SMOIOLI/synced/repos/dashboard/node_modules/loader-runner/lib/LoaderRunner.js:214:10)
at Array.<anonymous> (/Users/SMOIOLI/synced/repos/dashboard/node_modules/loader-runner/lib/LoaderRunner.js:205:4)
at Storage.finished (/Users/SMOIOLI/synced/repos/dashboard/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:55:16)
at /Users/SMOIOLI/synced/repos/dashboard/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:91:9
at /Users/SMOIOLI/synced/repos/dashboard/node_modules/graceful-fs/graceful-fs.js:123:16
at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read_file_context:68:3) {
opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
library: 'digital envelope routines',
reason: 'unsupported',
code: 'ERR_OSSL_EVP_UNSUPPORTED'
}
```

You can force Node to use the legacy openssl provider via:

```
export NODE_OPTIONS=--openssl-legacy-provider
```

The need for this option will be removed as soon as later Node versions get supported.

0 comments on commit ec6829f

Please sign in to comment.