nvm/README.markdown

# Node Version Manager

## Installation

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.

To install create a folder somewhere in your filesystem with the "`nvm.sh`" file inside it.  I put mine in a folder called "`.nvm`".

Or if you have `git` installed, then just clone it:

    git clone git://github.com/creationix/nvm.git ~/.nvm

To activate nvm, you need to source it from your bash shell

    . ~/.nvm/nvm.sh

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.
    
## Usage

To download, compile, and install the v0.4.1 release of node, do this:

    nvm install v0.4.1

And then in any new shell just use the installed version:

    nvm use v0.4.1

If you want to see what versions are available:

    nvm ls

To restore your PATH, you can deactivate it.

    nvm deactivate

To set a default Node version to be used in any new shell, use the alias 'default':

    nvm alias default v0.4.1

## Problems

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.
2010-04-16 01:00:34 +08:00			`# Node Version Manager`

			`## Installation`

Trim and update nvm 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
Make the gist work as it's own repo. 2010-04-16 01:14:52 +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`".

			Or if you have `git` installed, then just clone it:

Remove clone and update, these are better done by hand, add listlibs and a way to use the latest stable version 2010-05-07 01:51:43 +08:00			`git clone git://github.com/creationix/nvm.git ~/.nvm`
2010-04-16 01:00:34 +08:00
Trim and update nvm 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
Trim and update nvm 2010-12-11 03:32:16 +08:00			`. ~/.nvm/nvm.sh`
Install npm automatically 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.`
Trim and update nvm 2010-12-11 03:32:16 +08:00
2010-04-16 01:00:34 +08:00			`## Usage`

Update readme and comment 2011-02-26 03:53:38 +08:00			`To download, compile, and install the v0.4.1 release of node, do this:`
2010-04-16 01:00:34 +08:00
Update readme and comment 2011-02-26 03:53:38 +08:00			`nvm install v0.4.1`
2010-04-16 01:00:34 +08:00
			`And then in any new shell just use the installed version:`

Update readme and comment 2011-02-26 03:53:38 +08:00			`nvm use v0.4.1`
2010-04-16 01:00:34 +08:00
Fix README for ls command 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
Trim and update nvm 2010-12-11 03:32:16 +08:00			`nvm ls`
2010-04-16 01:03:42 +08:00
Trim and update nvm 2010-12-11 03:32:16 +08:00			`To restore your PATH, you can deactivate it.`
2010-04-16 01:03:42 +08:00
Trim and update nvm 2010-12-11 03:32:16 +08:00			`nvm deactivate`
Fix a typo in the docs. 2010-05-07 07:33:46 +08:00
Add a special "default" alias If you set a "default" alias, it will automatically be loaded when you start a new shell. 2011-01-23 02:16:24 +08:00			`To set a default Node version to be used in any new shell, use the alias 'default':`

Update readme and comment 2011-02-26 03:53:38 +08:00			`nvm alias default v0.4.1`
Add a special "default" alias If you set a "default" alias, it will automatically be loaded when you start a new shell. 2011-01-23 02:16:24 +08:00
Remove downloads from /src if installation failed 2011-11-14 21:48:56 +08:00			`## Problems`

			`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.`