diff --git a/docs/_config.yml b/docs/_config.yml index d8706c14f7..ae271e28c7 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -95,6 +95,7 @@ sidebar_categories: Troubleshooting: - expired-certificate - windows + - known-issues github_repo: 'meteor/meteor' edit_branch: 'devel' edit_path: 'docs' diff --git a/docs/source/known-issues.md b/docs/source/known-issues.md new file mode 100644 index 0000000000..584464b279 --- /dev/null +++ b/docs/source/known-issues.md @@ -0,0 +1,39 @@ +--- +title: Known issues in 2.13 +description: Troubleshooting in Meteor 2.13 +--- + +

Cannot extract version of meteor tool

+ +For some users, the `meteor update` to version 2.13 command may fail with the following error or similar: + +```shell +Error: incorrect data check + at Zlib.zlibOnError [as onerror] (zlib.js:187:17) + => awaited here: + ... + at /tools/cli/main.js:1165:7 { + errno: -3, + code: 'Z_DATA_ERROR' + } + +``` +

The issue

+ +It seems related to [our first ESM version of Node.js v14.21.4](https://github.com/meteor/node-v14-esm) and the `zlib` package. +We have been able to reproduce this issue only in Mac Intel. + +You can follow along with the [GitHub issue](https://github.com/meteor/meteor/issues/12731) for updates. + +

Workaround

+ +The workaround while our developers are working on this issue is as follows: + +running the following command in your terminal: + +```shell + +curl https://install.meteor.com/\?release\=2.12 | sh + +``` +