The site works under MacOS and Unix systems, but not on Windows, because many 3rd party modules are not compatible with Windows.

Create a folder /js for the project. You can use any other directory as well, just adjust the paths below.

Node.JS – the last version from https://nodejs.org.

MongoDB - can be either 2.6+ or newer.

Use packages for Linux, MacPorts or Homebrew for Mac.

If you have macports then:

sudo port install mongodb
sudo port load mongodb

Hopefully, you have Git installed and running.

Clone the tutorial server:

cd /js
git clone https://github.com/iliakan/javascript-tutorial-server

Install these:

npm install -g mocha bunyan gulp nodemon

To set up NODE_PATH environment variable, further on we use an alias for running gulp:

alias glp="npm --silent run gulp -- "

Or, without the alias, you can run gulp as: NODE_PATH=./handlers:./modules gulp ....

Or like this: npm --silent run gulp -- ....

You'll also need to install nginx and GraphicsMagick (for image resizing).

For MacPorts, the commands are:

sudo port install GraphicsMagick
sudo port install nginx +debug+gzip_static+realip+geoip

sudo port load nginx

In the directory with javascript-tutorial-server, run:

npm install

If you had no nginx before, then everything is simple.

The logs directory is /var/log/nginx.

Create it and set owner/permissions. For a personal computer, can do it like this:

mkdir /var/log/nginx
chmod 777 /var/log/nginx

Create configs by running:

npm --silent run gulp -- config:nginx --prefix /opt/local/etc/nginx --root /js/javascript-tutorial-server --env development --clear

Here --prefix -- is the directory for nginx config, usually /etc/nginx, for MacPorts it's /opt/local/etc/nginx.

The --root is where the server is located. If you used another path instead of /js/javascript-tutorial-server, then change it.

The --clear option clears all configs before creating the new ones. That's fine if you had no nginx before.

Also it's recommended to add this line to /etc/hosts:

127.0.0.1 javascript.in

This host name is in the Nginx config already.

If you already have nginx, make a backup of it's config files.

Then execute the prevous section without the --clear at the end:

npm --silent run gulp -- config:nginx --prefix /opt/local/etc/nginx --root /js/javascript-nodejs --env development

The command copies files from the directory /js/javascript-tutorial-server/nginx into the folder --prefix, but without removing old configs.

So if you had other sites in sites-enabled, they will not be removed.

Rerun nginx. Make sure your existing projects work.

Copy the tutorial repo, for instance javascript-tutorial-en

cd /js
git clone https://github.com/iliakan/javascript-tutorial-en

After that, import it with the command:

PLUNK_REMOTE_OFF=1 npm --silent run gulp -- tutorial:import --root /js/javascript-tutorial-en

Here /js/javascript-tutorial-en -- the directory with the tutorial repository.

PLUNK_REMOTE_OFF=1 disables automatic uploading of examples to plnkr.co. That requires to setup a plnkr session, and is not necessary to run the tutorial.

Run the site with the language in NODE_LANG variable:

HOST=127.0.0.1 PORT=80 NODE_LANG=en ./dev

Or with default host 127.0.0.1 and port 3000:

NODE_LANG=en ./dev

Then access the site.

If you have 127.0.0.1 javascript.in in /etc/hosts, then the address will be http://javascript.in:3000.

In "Edit" mode the engine watches the tutorial directory, instantly picks the changes and reloads the page. Good for editing.

PLUNK_REMOTE_OFF=1 NODE_LANG=en ./edit

This uses the default HOST=127.0.0.1, PORT=3000, and the folder is /js/javascript-tutorial-en.

If something doesn't work -- file an issue.