Users may encounter errors related to symbolic links and node version incompatibility.
FastStore users may encounter the following errors after installing the Headless CMS plugin.
Error message | Possible cause | Solution |
---|---|---|
Error: EPERM: operation not permitted, symlink | Your device isn’t enabled for development. | Enable Developer Mode in your machine |
error @oclif/core@1.26.2: The engine "node" is incompatible with this module. Expected version ">=14.0.0". Got "12.12.0" | The VTEX IO CLI’s node version isn’t updated. Expected version was >=14.0.0 , but the current version is 12.12.0 . | Update VTEX IO CLI |
Solutions
To solve these issues, follow the instructions below:
Enable Developer Mode on your machine
While running the vtex plugins install cms
, Windows users can get the following error:
_10vtex plugins install cms_10warning "@vtex/cli-plugin-cms > @vtex/api > apollo-server-core > apollo-graphql@0.9.5" has incorrect peer dependency "graphql@^14.2.1 || ^15.0.0"._10Installing plugin @vtex/cli-plugin-cms... failed_10 Error: EPERM: operation not permitted, symlink_10 'C:\Users\LukeSkywalker\AppData\Roaming\npm\node_modules\vtex' ->_10 'C:\Users\LukeSkywalker\AppData\Local\vtex\node_modules\vtex'_10 Code: EPERM
FastStore projects rely on creating symbolic links (symlinks). To solve this error, you must enable Developer Mode on your machine. Developer Mode grants the necessary permissions and privileges to use symlinks, which reduces the probability of encountering errors during development.
Running the FastStore project as an administrator isn't recommended.
Learn how to enable Developer Mode in Microsoft's official guide Enable your device for development.
After enabling Developer Mode, launch Windows Terminal and run vtex cms
. This will allow the system to create the necessary symlinks for running commands from the Headless CMS plugin.
Update VTEX IO CLI
If you run the vtex plugins install cms
command and get the error below, you need to update the VTEX IO CLI version you're using.
_10vtex plugins install cms_10error @oclif/core@1.26.2: The engine "node" is incompatible with this module. Expected version ">=14.0.0". Got "12.12.0"_10error Found incompatible module._10Installing plugin @vtex/cli-plugin-cms... failed_10 Error: yarn add @vtex/cli-plugin-cms@latest --non-interactive --mutex=file:C:\Users\barbara.celi\AppData\Local\vtex\yarn.lock --preferred-cach
Even if you update the node
version on your machine, you must also keep VTEX IO CLI updated to avoid errors.
To update VTEX IO CLI, open Windows Terminal and follow these instructions:
- Run the
vtex autoupdate
command in Windows Terminal. - Run the
vtex -v
command to check if the VTEX IO CLI andnode
versions are updated. - Run the
vtex plugins install cms
command to install the Headless CMS plugins. - Check if the installation of Headless CMS plugins was successful by running
vtex cms
. You should see the following:
_10$ vtex cms_10Syncs CMS schemas with the current workspace in use._10_10USAGE_10 $ vtex cms COMMAND_10COMMANDS_10 cms sync Syncs CMS schemas with the current workspace in use.