nvm/README.markdown

95 lines
2.5 KiB
Markdown
Raw Normal View History

2010-04-16 01:00:34 +08:00
# Node Version Manager
## Installation
2010-12-11 03:32:16 +08:00
First you'll need to make sure your system has a c++ compiler. For OSX, XCode will work, for Ubuntu, the build-essential and libssl-dev packages work.
2010-04-16 01:06:53 +08:00
2012-04-06 23:49:48 +08:00
To install create a folder somewhere in your filesystem with the "`nvm.sh`" file inside it. I put mine in a folder called "`nvm`".
2010-04-16 01:14:52 +08:00
Or if you have `git` installed, then just clone it:
2012-03-24 04:04:45 +08:00
git clone git://github.com/creationix/nvm.git ~/nvm
2010-04-16 01:00:34 +08:00
2010-12-11 03:32:16 +08:00
To activate nvm, you need to source it from your bash shell
2010-04-16 01:00:34 +08:00
2012-03-24 22:02:03 +08:00
. ~/nvm/nvm.sh
2010-12-11 03:42:19 +08:00
I always add this line to my ~/.bashrc or ~/.profile file to have it automatically sources upon login.
Often I also put in a line to use a specific version of node.
2010-12-11 03:32:16 +08:00
2010-04-16 01:00:34 +08:00
## Usage
2012-03-24 22:03:23 +08:00
To download, compile, and install the v0.6.14 release of node, do this:
2010-04-16 01:00:34 +08:00
2012-03-24 22:03:23 +08:00
nvm install v0.6.14
2010-04-16 01:00:34 +08:00
2010-04-16 01:00:34 +08:00
And then in any new shell just use the installed version:
2012-03-24 22:03:23 +08:00
nvm use v0.6.14
2010-04-16 01:00:34 +08:00
2011-10-29 16:04:37 +08:00
Or you can just run it:
2012-03-24 22:03:23 +08:00
nvm run v0.6.14
2011-10-29 16:04:37 +08:00
2011-01-23 02:13:02 +08:00
If you want to see what versions are available:
2010-04-16 01:00:34 +08:00
2010-12-11 03:32:16 +08:00
nvm ls
2010-04-16 01:03:42 +08:00
2010-12-11 03:32:16 +08:00
To restore your PATH, you can deactivate it.
2010-04-16 01:03:42 +08:00
2010-12-11 03:32:16 +08:00
nvm deactivate
2010-05-07 07:33:46 +08:00
To set a default Node version to be used in any new shell, use the alias 'default':
2012-03-24 22:03:23 +08:00
nvm alias default 0.6
2012-04-09 14:25:49 +08:00
## Bash completion
To activate, you need to source `bash_completion`:
[[ -r $NVM_DIR/bash_completion ]] && . $NVM_DIR/bash_completion
Put the above sourcing line just below the sourcing line for NVM in your profile (`.bashrc`, `.bash_profile`).
### Usage
nvm
$ nvm [tab][tab]
alias copy-packages help list run uninstall version
clear-cache deactivate install ls unalias use
nvm alias
$ nvm alias [tab][tab]
default
$ nvm alias my_alias [tab][tab]
v0.4.11 v0.4.12 v0.6.14
nvm use
$ nvm use [tab][tab]
my_alias default v0.4.11 v0.4.12 v0.6.14
nvm uninstall
$ nvm uninstall [tab][tab]
my_alias default v0.4.11 v0.4.12 v0.6.14
## Problems
2012-04-06 23:49:48 +08:00
If you try to install a node version and the installation fails, be sure to delete the node downloads from src (~/nvm/src/) or you might get an error when trying to reinstall them again or you might get an error like the following:
curl: (33) HTTP server doesn't seem to support byte ranges. Cannot resume.
Where's my 'sudo node'? Checkout this link:
https://github.com/creationix/nvm/issues/43
on Arch Linux and other systems using python3 by default, before running *install* you need to
export PYTHON=python2