Documentation
Feedback
Guides
Storefront Development

Storefront Development
FastStoreIntegrating your storefront with Headless CMS
Why is Headless CMS plugin installation failing on Windows?
If you are a Windows user, you may find the following error after requesting to install the Headless CMS plugin of VTEX IO CLI:

_10
vtex plugins install cms
_10
warning "@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".
_10
Installing 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 the Developer Mode in your machine. Since FastStore projects rely on creating symbolic links (symlinks), this mode grants the necessary permissions and privileges, reducing the chance of errors during development.
Running the FastStore project as an Administrator is not recommended.
  1. To enable Developer Mode, refer to Microsoft's official guide on Enabling your device for development.
  2. After enabling the mode, launch the Windows Terminal and then, run vtex cms.This will allow the system to create the symlinks necessary for running commands from the Headless CMS plugin.
Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page