How to Install Node.js and NGINX on Debian 8

Updated April 11, 2017 Originally authored by Joe D.

This guide was written for Debian 8. Other distributions are available:

Select distribution:

Traducciones al Español
Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.

Deprecated
This guide has been deprecated and is no longer being maintained. Please refer to the updated version of this guide.

Create a Linode account to try this guide with a $ credit.

This credit will be applied to any valid services used during your first days.

Node.js is a JavaScript platform which can serve dynamic, responsive content. JavaScript is usually a client-side, browser language like HTML or CSS. However, Node.js is a server-side, JavaScript platform, comparable to PHP. Node.js often works with other popular server applications like NGINX or Apache. In this guide, NGINX is configured to handle front-end, static file requests, and Node.js is configured to handle back-end file requests.

Install and Configure NGINX

This guide can be started immediately after terminal login on a new Linode, it’s written for the root user. However, before installation you might want to make sure the Linode is up-to-date with our Getting Started guide and secured with our Securing Your Server guide.

Install NGINX as well as screen, which you’ll use later:
```
apt-get install nginx screen
```
Start NGINX:
```
service nginx start
```
Change the working directory to the NGINX sites-available directory:
```
cd /etc/nginx/sites-available/
```

Create a new sites-available file, replacing example.com with your domain or IP address:

File: /etc/nginx/sites-available/example.com

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
#Names a server and declares the listening port
server {
    listen 80;
    server_name example.com www.example.com;

    #Configures the publicly served root directory
    #Configures the index file to be served
    root /var/www/example.com;
        index index.html index.htm;

    #These lines create a bypass for certain pathnames
    #www.example.com/test.js is now routed to port 3000
    #instead of port 80
    location /test.js {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
    }
}

Change the working directory to the NGINX sites-enabled directory:
```
cd /etc/nginx/sites-enabled/
```
Create a symlink to the new example sites-available file:
```
ln -s /etc/nginx/sites-available/example.com
```
Remove the default symlink:
```
rm default
```
Load the new NGINX configuration:
```
service nginx reload
```

Create the Directories and HTML Index File

NGINX is now configured. However, the example.com server block points to directories and files that still need to be created.

Create the /var/www and /var/www/example.com directories:
```
mkdir -p /var/www/example.com
```
Change the working directory:
```
cd /var/www/example.com
```

Create the HTML index file:

File: /var/www/example.com/index.html

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<!DOCTYPE html>
<html>
<body>

<br>
<br>

<center>
<p>
<b>
If you have not finished the <a href="https://www.linode.com/docs/guides/nodejs-nginx-debian">guide</a>, the button below will not work.
</b>
</p>
</center>

<center>
<p>
The button links to test.js. The test.js request is passed through NGINX and then handled by the Node.js server.
</p>
</center>

<center>
<a href="test.js">
<button type="button">Go to test.js</button>
</a>
</center>

</body>
</html>

Install Node.js and Write a Web Server

NGINX is now listening on port 80 and serving content. It’s also configured to pass /test.js requests to port 3000. The next steps are to install Node.js, then write a server with Node.js. The new server listens on port 3000.

Install the Node Version Manager:

wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

Close and reopen your terminal.
Install Node.js:
```
nvm install 0.10
```

While still in the /var/www/example.com directory, create a Node.js server:

File: /var/www/example.com/server.js

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
//nodejs.org/api for API docs
//Node.js web server
var http = require("http"),                           //Import Node.js modules
    url = require("url"),
    path = require("path"),
    fs = require("fs");

http.createServer(function(request, response) {       //Create server
var name = url.parse(request.url).pathname;           //Parse URL
var filename = path.join(process.cwd(), name);        //Create filename
fs.readFile(filename, "binary", function(err, file) { //Read file
    if(err) {                                         //Tracking Errors
        response.writeHead(500, {"Content-Type": "text/plain"});
        response.write(err + "\n");
        response.end();
        return;
    }
    response.writeHead(200);                          //Header request response
    response.write(file, "binary");                   //Sends body response
    response.end();                                   //Signals to server that
 });                                                  //header and body sent
}).listen(3000);                                      //Listening port
console.log("Server is listening on port 3000.")      //Terminal output

Run a new screen session:
```
screen
```
Press return and run the Node.js server:
```
node server.js
```
Exit the screen by pressing Ctrl+a then d.

Create the Test.js File

NGINX is listening on port 80 and passing any /test.js requests to port 3000. Node.js is listening on port 3000 and serving any file requests. Next, write a /test.js file.

Create the file:

File: /var/www/example.com/test.js

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<!DOCTYPE html>
<html>
<body>

<center>
<h2>
Your Node.JS server is working.
</h2>
</center>

<center>
<p>
The below button is technically dynamic. You are now using Javascript on both the client-side and the server-side.
</p>
</center>
<br>

<center>
<button type="button"
onclick="document.getElementById('sample').innerHTML = Date()">
Display the date and time.
</button>
<p id="sample"></p>
</center>

</body>
</html>

Test the NGINX server at the IP address or domain. Use the “Go to test.js” button to test that the Node.js server is serving files. On the test page, the “Display the date and time” button will execute a client-side snippet of JavaScript to return the current time.

[Node.js](http://nodejs.org) and [NGINX](http://nginx.com/) are now working together. Route requests to one server or the other depending on your needs. Node.js offers a large [API](http://nodejs.org/api) with many tools. With Node.js, a developer can stay within the JavaScript language while working client-side or server-side.

For next steps, look into technologies like WebSockets, iframes, or framesets. And for developing in JavaScript, try Express.js, Ember.js, jQuery, or the Node Package Manager for modules.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

This page was originally published on January 14, 2015.

debian nginx web server proxy

Join the conversation.

Read other comments or post your own below. Comments must be respectful, constructive, and relevant to the topic of the guide. Do not post external links or advertisements. Before posting, consider if your comment would be better addressed by contacting our Support team or asking on our Community Site.

The Disqus commenting system for Linode Docs requires the acceptance of Functional Cookies, which allow us to analyze site usage so we can measure and improve performance. To view and create comments for this article, please update your Cookie Preferences on this website and refresh this web page. Please note: You must have JavaScript enabled in your browser.

Compute

Storage

Databases

Networking

Developer Tools

Delivery

Security

Services

Industries

Pricing

Community

Engage With Us

Search Results

No Results

Filters

How to Install Node.js and NGINX on Debian 8

Install and Configure NGINX

Create the Directories and HTML Index File

Install Node.js and Write a Web Server

Create the Test.js File

More Information

Your Feedback Is Important

On this page