Windows users may encounter the 'EPERM: operation not permitted' error during the installation of the Headless CMS plugin.
If you are a Windows user, you may encounter the following error after installing the Headless CMS plugin:
_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
To solve this issue, enable Developer Mode in your machine. FastStore projects rely on creating symbolic links (symlinks), and this mode grants the necessary permissions and privileges to use them, which reduces the probability of encountering errors during development.
Running the FastStore project as an Administrator is not recommended.
-
To enable Developer Mode, refer to 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.