Skip to content

Commit

Permalink
Add NVM related docs.
Browse files Browse the repository at this point in the history
  • Loading branch information
sarahelsaig committed Mar 6, 2022
1 parent 3c925d5 commit 7a3ecb6
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 0 deletions.
12 changes: 12 additions & 0 deletions Lombiq.Tests.UI/Docs/Linux.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Linux-specific considerations



## Global NPM vs Userspace NPM via Node Version Manager


As Linux has a stricter access policy you may want to install NPM in the userspace so you can still install global packages (e.g. html-validate) without sudoing. The easiest way to do this is via NVM. If you don't have NVM yet, [follow the guide here](https://github.com/Lombiq/NPM-Targets/tree/dev#global-npm-vs-userspace-npm-via-node-version-manager-on-linux).

As of writing this document, [Atata doesn't run bash as login shell](https://github.com/atata-framework/atata-cli/issues/1) so NVM wouldn't be loaded and the executables of globally installed packages' CLI executables won't be available. There are two workarounds for this:
* Run your dev environment inside an NVM scope. For example: `nvm exec default rider`, `nvm exec default code`, etc.
* Create a proxy command for each using the function from the NVM setup guide above, e.g.: `proxy-nvm-command html-validate`.
1 change: 1 addition & 0 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ Do you want to quickly try out this project and see it in action? Check it out i
- [Troubleshooting](Lombiq.Tests.UI/Docs/Troubleshooting.md)
- [Limits](Lombiq.Tests.UI/Docs/Limits.md)
- [Tools we use](Lombiq.Tests.UI/Docs/Tools.md)
- [Linux-specific considerations](Lombiq.Tests.UI/Docs/Linux.md)


## Contributing and support
Expand Down

0 comments on commit 7a3ecb6

Please sign in to comment.