148

Supposed I have written a Node.js application, and I now would like to distribute it. Of course, I want to make it easy for the user, hence I do not want him to install Node.js, run npm install and then manually type node app.js.

What I'd prefer was a single executable file, e.g. an .exe file on Windows.

How could I approach this?

I am aware of this thread, anyway this is only about Windows. How could I achieve this in a platform-independent manner? Any ideas? Best practices? ...?

The perfect solution was a "compiler" I can give a source folder to. The source folder contains the app itself in various .js files, the node_modules folder and some metadata, such as the package.json. The output should be binaries for various platforms, such as Windows, OS X and Linux.

Oh, and what's important: I do not want to make any changes to the source code, so calls to require with relative paths should still work, even if this relative path is now inside the packaged app.

Any ideas?

PS: I do not want the user to install Node.js independently, it should be included inside the executable as well.

5
  • 1
    Is this a webapp? (Meaning in has a web based UI) or a simpler command line app that does something else? I suspect this gets much harder if you need to spawn a browser of some kind.
    – Alex Wayne
    Commented Jan 14, 2013 at 6:18
  • 7
    Number of node.js community members who deploy to unix OSes this way: zero. Are you sure the tried-and-true approaches like a tar archive, deb, or rpm are not acceptable for you? Are you inventing a problem to solve that doesn't truly exist? Commented Jan 14, 2013 at 6:18
  • 1
    @ Alex Wayne: It's a server-side app, hence no need to start a browser.
    – Golo Roden
    Commented Jan 14, 2013 at 6:22
  • 2
    PS: Moreover, my question includes whether there is one tool I can use to create a solution for any platform, so even a tool which automatically creates a .exe file for Windows and a .deb file would be great ;-)
    – Golo Roden
    Commented Jan 14, 2013 at 8:27
  • @PeterLyons I find that hard to believe. I can also prove it.
    – oxygen
    Commented Nov 18, 2016 at 16:06

7 Answers 7

69

Meanwhile I have found the (for me) perfect solution: nexe, which creates a single executable from a Node.js application including all of its modules.

It's the next best thing to an ideal solution.

8
  • 13
    According to the documentation, nexe supports Windows now :)
    – Lea Rosema
    Commented Mar 3, 2015 at 13:48
  • 1
    I bundled my nodeJS app and I got this error: Error: ENOENT, no such file or directory '..../release/types/mime.types' I looked at the release folder, the types/mime.types folder was never created. Anyone got any ideas?
    – Gang Su
    Commented Apr 21, 2015 at 23:39
  • 1
    As the current maintainer of nexe, native modules have been in progress for a bit now, and rest assured will be implemented soon! Commented Aug 9, 2015 at 16:14
  • 1
    Great, thanks for the update :-)
    – Golo Roden
    Commented Aug 9, 2015 at 16:14
  • 7
    The lack of support for native modules is quite a hindrance. Also, latest releases of nexe have a hard time with dynamic paths, which are very common in the most popular npm packages.
    – ruffrey
    Commented Mar 30, 2016 at 16:42
32

First, we're talking about packaging a Node.js app for workshops, demos, etc. where it can be handy to have an app "just running" without the need for the end user to care about installation and dependencies.

You can try the following setup:

  1. Get your apps source code
  2. npm install all dependencies (via package.json) to the local node_modules directory. It is important to perform this step on each platform you want to support separately, in case of binary dependencies.
  3. Copy the Node.js binary – node.exe on Windows, (probably) /usr/local/bin/node on OS X/Linux to your project's root folder. On OS X/Linux you can find the location of the Node.js binary with which node.

For Windows:
Create a self extracting archive, 7zip_extra supports a way to execute a command right after extraction, see: http://www.msfn.org/board/topic/39048-how-to-make-a-7-zip-switchless-installer/.

For OS X/Linux:
You can use tools like makeself or unzipsfx (I don't know if this is compiled with CHEAP_SFX_AUTORUN defined by default).

These tools will extract the archive to a temporary directory, execute the given command (e.g. node app.js) and remove all files when finished.

1
  • 2
    Is such packaging legal according to nodejs license?
    – Pacerier
    Commented Oct 30, 2017 at 21:23
15

Not to beat a dead horse, but the solution you're describing sounds a lot like Node-Webkit.

From the Git Page:

node-webkit is an app runtime based on Chromium and node.js. You can write native apps in HTML and JavaScript with node-webkit. It also lets you call Node.js modules directly from the DOM and enables a new way of writing native applications with all Web technologies.

These instructions specifically detail the creation of a single file app that a user can execute, and this portion describes the external dependencies.

I'm not sure if it's the exact solution, but it seems pretty close.

Hope it helps!

4
  • 2
    Node-Webkit is just fantastic, especially to demo a Node.js solution, you have everything you need in one place.
    – Ewald
    Commented Sep 11, 2014 at 9:51
  • 2
    The electron framework is also good. But both nwjs and electron are focused on UI-centric apps. Packaging up a server app is probably possible, but not a typical use case. In my experience it's been extra work to hide the UI and run it from the CLI.
    – ruffrey
    Commented Mar 30, 2016 at 16:45
  • Is Nodewebkit packaging legal according to nodejs license?
    – Pacerier
    Commented Oct 30, 2017 at 21:24
  • 1
    @Pacerier I believe it is, but IANAL. That being said, Electron has really superseded it, and I'm sure GitHub's lawyers made sure it's compliant. Commented Oct 31, 2017 at 14:53
8

JXcore will allow you to turn any nodejs application into a single executable, including all dependencies, in either Windows, Linux, or Mac OS X.

Here is a link to the installer: https://github.com/jxcore/jxcore-release

And here is a link to how to set it up: http://jxcore.com/turn-node-applications-into-executables/

It is very easy to use and I have tested it in both Windows 8.1 and Ubuntu 14.04.

FYI: JXcore is a fork of NodeJS so it is 100% NodeJS compatible, with some extra features.

4
7

In addition to nexe, browserify can be used to bundle up all your dependencies as a single .js file. This does not bundle the actual node executable, just handles the javascript side. It too does not handle native modules. The command line options for pure node compilation would be browserify --output bundle.js --bare --dg false input.js.

1
  • i use it like this: browserify --bare input.js > output.js
    – Elmer
    Commented Feb 24, 2015 at 14:19
7

There are a number of steps you have to go through to create an installer and it varies for each Operating System. For Example:

2
0

You could create a git repo and setup a link to the node git repo as a dependency. Then any user who clones the repo could also install node.

#git submodule [--quiet] add [-b branch] [-f|--force]
git submodule add /var/Node-repo.git common

You could easily package a script up to automatically clone the git repo you have hosted somewhere and "install" from one that one script file.

#!/bin/sh
#clone git repo
git clone your-repo.git
1
  • 2
    But this would give you the source repository, not the binary. The user still needs to compile Node.js, given that all dependencies for doing so are already present (which is not the case on Windows/OS X 'out of the box' installations).
    – user409030
    Commented Jan 30, 2013 at 10:34

Not the answer you're looking for? Browse other questions tagged or ask your own question.