So you wrote your Node.js application and need a way to launch it online? Here, I present a guide on setting things up that doesn't require prior knowledge of anything OS-related. First, let's go through the pros and cons of hosting your app on VPS. Pros: it's cheap you can host multiple projects on the same server (perfect for side projects) you have a lot of control over server administration Cons: it takes longer to set everything up it adds some time to maintain your server Ultimately, I recommend going this route if you like trying new things and want to learn some DevOps. For the sake of this guide, you will need your app, a VPS, and a domain name. Installing required software Assuming you're just started with a fresh VPS, you'll likely have a clean Ubuntu. We will need to install Node.js (to run your app), nginx (to set up a reverse proxy; more on that later), and certbot (to issue an SSL certificate). You will also likely need a DB (e.g. MySQL or PostgreSQL), but that's up to you. The easiest way to install these packages is to use . Look into documentation of the corresponding projects to get up-to-date instructions. apt Once you're done, you will also need to install , Node.js process manager: pm2 npm install pm2 And we're done! Now let's set it all up. Downloading and running your app Well, assuming you already have your code hosted on GitHub, this should be easy. should make its job. git clone One thing I should mention is that you will need to . That way, your server will be able to pull your private repository without password input. It's also much faster than type password manually each time you're pulling the newest code on your server. create an SSH key and link it to your GitHub Let's test an app by running it. npm install node src/app.js pm2 As I mentioned, pm2 is a process management tool for your Node.js apps. It can do a lot of stuff like logging your app's output, recording hardware resource usage, restarting your app in case it goes down, but right now we're interested in starting an app in "daemon" mode. In short, "daemon" means your app won't stop when you press Ctrl+C or close a console window. Instead, it will run in the background until you explicitly tell it to stop. To start an app, run pm2 start src/app.js --name nodejs-app And that's it! Your app is running in the background, forever. Now you can control your app by its name: pm2 stop nodejs-app pm2 start nodejs-app pm2 restart nodejs-app nginx Now, nginx is a lot of things, really. Here, we will only scratch its surface by setting up a reverse proxy for our app. So what's a reverse proxy? Here's one way to put it: reverse proxy is a middleman between client and server that transforms an external route into an internal route. Say, if nginx catches request //app1.example http: .org it will route that request to an app deployed on port 3000, which is the port that we are using for our app. //app2.example http: .org can route to an app on port 3001, and so forth. Our config will include the domain we're expecting requests from, , and the port at which our app is deployed, . http://app.example.org 3000 First, create a configuration for your app: nano /etc/nginx/sites-enabled/app.example.org.conf Then, paste the following: server { server_name app.example.org; listen 80; location / { proxy_pass http://localhost:3000/; proxy_set_header Host ; proxy_cache_bypass ; } } $host $http_upgrade Finally, test that our config is ok and restart nginx. nginx -t systemctl restart nginx Now, if you actually want to test this thing, you will need a domain. The subdomain will also work fine, just replace all above with your full domain name. app.example.org Woohoo! You (and everyone else!) should now be able to access your app by typing its URL in a browser bar. certbot We're almost done! The final step is to set up an SSL certificate for your app so you can access it via . https We will do this via — a CLI tool for the awesome certificate service called Let's Encrypt. certbot Start by simply typing certbot You will see a list of domains. Likely you will have only one, the one we configured above, so it will be hard to choose the wrong one. Follow the guide, as certbot will create a certificate and update your nginx configuration. And that's it. Now, when you type your URL, it will work with https. Not only that, but it will also redirect non-secure http calls to https as well (if you chose that during configuration). Wrapping up I hope you didn't get lost in the process and successfully launched your app. If you found yourself spending an hour or two, don't worry: it will be much faster next time. Once you master it, you will be able to push projects to the Web in minutes!
