✈ Make Node.js portable on Windows
Clone or download


Node.js Portable is now integrated on Neard !

GitHub release Total downloads AppVeyor Go Report Code Quality Donate Paypal

Read this in other languages: English, 简体中文.


A single EXE written in Go to make Node.js portable on Windows systems.
Tested on Windows 7, Windows 8.1 and Windows 10.

Main window of Node.js Portable

Configuration file nodejs-portable.conf is generated at first launch :


  • Download the latest release.
  • Put nodejs-portable.exe in a new empty folder.

Add it to a white list if you receieved a warning from anti-virus software.

Getting started

Run nodejs-portable.exe, then choose task :

  • 1 to install node.js by entering version and architecture.
  • 2 to launch Node.js shell.

If you have already installed Node.js, create a folder named app and put your node.js environment inside, then launch nodejs-portable.exe. (See #35)

Config file nodejs-portable.conf

  • workPath : Shell working dir (can be relative to nodejs-portable.exe).
  • customPaths : Array of custom paths that will be placed in the PATH environment variable (paths can be relative to nodejs-portable.exe).
  • immediateMode: Set this to true if you want to use node shell immediately.

If an exception happened, take a look into nodejs-portable.log for further information.

Command line

Node.js Portable can be used through the command line to inject arguments directly to node :

$ nodejs-portable.exe --version

Take a look into nodejs-portable.log if you have any issue.


  • Install Go 1.11+
  • Add Go to your PATH (ex. C:\Go\bin)
  • Install Java SE Development Kit 1.8+
  • Add Java to your PATH (ex. C:\Program Files (x86)\Java\jdk1.8.0_144\bin)
  • Install Apache Ant 1.9+
  • Add Ant to your PATH (ex. C:\apache-ant\bin)


  • Clone this repository to $GOPATH/src/github.com/crazy-max/nodejs-portable
  • Run ant release. The artefact will be available in bin\release

If you don't want to use Java/Ant to build the project, run :

set GOARCH=386
go mod download
go generate -v
go build -v -ldflags "-s -w"

How can i help ?

All kinds of contributions are welcomed 🙌!
The most basic way to show your support is to star 🌟 the project, or to raise issues 💬
But we're not gonna lie to each other, I'd rather you buy me a beer or two 🍻!



MIT. See LICENSE for more details.
USB icon credit to Dakirby309.