rancher
/
dashboard
mirror of https://github.com/rancher/dashboard.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

quickstart: document a known failure case and workaround

This commit is contained in:
Silvio Moioli 2024-07-23 17:56:42 +02:00 committed by Richard Cox
parent f6bf080c41
commit ec6829f764
1 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docusaurus/docs/internal/getting-started/quickstart.md
View File

@ -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.