Deploy Koa.js Application to AWS EC2 ubuntu instance

I am developing a Koa application, which is a new web framework designed by the team behind Express. Here is a step-by-step tutorial on how to deploy the koa.js application on your Amazon Web Service (AWS) ubuntu server.

Firstly, launch the ubuntu instance on AWS. Then you need to change the security group.

Otherwise if you hit the public domain in browser, it would stuck at “Connecting” state until timeout. And the site can’t be reached as shown as the screenshot below:

By default, the launch wizard group only has type ssh.

Click “Edit” button add HTTP port 80 and HTTPS port 443 inbound rule:

Secondly, ssh into your instance, install nodejs according to the official documentations:

$ curl -sL | sudo -E bash -
$ sudo apt-get install -y nodejs

Thirdly, we use Nginx as reverse proxy server:

$ sudo apt-get update
$ sudo apt-get install nginx

Open the configuration file and edit as below. Be careful not to miss the semicolon:

server { 
    listen 80 default_server;
listen [::]:80 default_server;
    root /var/www/yourApp;
    location / {
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;

Save the file and restart nginx service:

$ sudo systemctl restart nginx

Finally, clone your git repository to the path /var/www/yourApp, you will get a permission denied, so change ownership of the folder. You may replace the ubuntu part to ‘whoami’:

$ sudo chown -R ubuntu /var/www

Run your server, for example a simple app.js:

var koa = require('koa');
var app = koa();

// logger

app.use(function *(next){
var start = new Date;
yield next;
var ms = new Date - start;
console.log('%s %s - %s', this.method, this.url, ms);

// response

app.use(function *(){
this.body = 'Hello World';


Start the server:

$ node app.js

Open your browser and hit your public domain:

Done. Leave a comment below if you have any questions 🙂

By Victor Leung

Experience in software development, consulting services and technical product management. Understanding of business and technology with an MBA in Finance and a Master degree in Computer Science. AWS Certified Solution Architect with experience in building products from scratch and serving as a charismatic leader.

Leave a comment

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: