In this brief tutorial you will learn how to setup a local server with Node.js. By the end you’ll be able to run a basic app version on your own virtual server. Let’s get started! 🚀 Why do you need a web server and what is it anyway? A virtual web server runs on your own computer with use of server software. If you’re an aspiring developer you will most definetly like this because it allows you to test features of any web application that you’ve build. Imagine you would upload your website or app for the world to see without testing it online. You couldn’t be sure if it works fine for other users. That’s no good, right? So, it’s good practice to always check how the features you’ve created work when accessing your site online. Install Node.js To get started, first we will need to install which is a run-time environment for (👉 in english: Node will help you execute JavaScript code). Node.js JavaScript Many developers get excited when talking about Node. Before only web browsers like Google Chrome had a JavaScript engine that could read and display code written in JavaScript. For Chrome this interpreter is called . The new feature that made Node so popular is that it allows JavaScript to run basically on all machines — which means the browser is no longer a restriction for the execution of JavaScript. V8 It’s save to say that Node is the best choice when building a simple server for all kind of web apps. So let’s install it. I will tell you two ways, one quick way to install and another option that’s a bit more complex at first but later on much more convenient. (1) Quick way to install Node.js Go to the and download the install package for your operating system. Use the LTS version not the current one. official page of Node.js After the download is complete install the package like any other app on your Mac or PC Next you can go to your Terminal program of choice. In case you don’t have a Terminal app like iTerm2 or Hyper installed, simply open the Terminal that comes pre-installed on every Mac. In case you are a Windows user check here . how to use terminal on Windows and don’t go crazy You can type the following command into your Terminal to see if everything was installed correctly: . If it works fine you should see a Node version number now. Also check if was installed with is the Node Package Manager that comes with Node when being installed. We will use it in the next steps to install Express and start our virtual server. $ node -v npm $ npm -v . Npm (2) Better way to install Node.js Instead of the above described way I prefer using which is a package manager for macOS. It allows you to install missing apps super fast via the Terminal. Windows users must take another package manager like instead. They are pretty similar and for demonstration purposes I will go with Homebrew and show you how to install Node via Homebrew. Homebrew Scoop Again you can go to the Terminal and paste the following promt (without the $-sign) in there. In case you’re wondering: it simply checks the GitHub repository from Homebrew and installs the app from there. $ /usr/bin/ruby -e "$(curl -fsSL )" https://raw.githubusercontent.com/Homebrew/install/master/install If Homebrew was installed correctly, we will be ready now to install Node with this simple command: $ brew install node You can check if everything is looking good by typing in: and (which should give you the version number of your installed Node). $ node -v $ npm -v But why make this effort to install Node via a package manager like Homebrew? There are several reasons this is a good idea: If you are using Node’s install manager it is possible that you run into access issues that require you to make changes in your system using a command called . $ sudo Also if you ever want to uninstall without Node this will be very messy as you need to track all the files that were created. Lastly, also it’s much easier to when using Homebrew. keep your Node version up-to-date Setup your first app You’re still with me, right? Great, so let’s finally go on and build an actual web app and local server! To do this quite conveniently we can use the which is a great command-line tool that creates an application skeleton for us. Otherwise you would be required to write more advanced code like setting up a server instance, configuring a view engine, etc. Although this is great to know it will not be necessary to run your first app on a web server. express-generator Express generator is straightforward. Simply take the following command and hack it into your terminal: . With the we install Express globally which means that you can access the package from any directory. $ npm install express-generator -g -g While still on the Terminal you can now create a new app with by typing: . In this example will be the name of your project. And guess what? You have just build your first app! To check into the myapp directory that we’ve just created you can type . express-generator $ express -v ejs -c sass myapp myapp $ cd myapp Admire the app you’ve just build Take a look at the project that you have just created. To see your files in the code editor just use this line: while still being in the myapp folder on your Terminal. myapp $ code . For this to work you must of course have installed a code editor like Visual Studio Code or Atom. When opening the editor you can see the project and all the files that were automatically created for you with Express generator. Within the index.ejs you can make edits and build your complex web app from there. For now let’s just leave it as is and continue to build our server. Setup of express-generator within the code editor We are almost there. Last thing: we must install various additional third-party packages (which are listed as dependencies in the file). These are commonly required by Express to run the server as you would expect it. Good news is that this will be pretty easy as you can install all of these via at once. Open up your Terminal and use this prompt: package.json npm . You can check if your installation was successful by going into your code editor again. You will see a new folder called like in my example above (hint: exclude this in case your uploading to GitHub). $ npm install node_modules Start your app on a virtual web server Finally let us run our app on a web server. And the very most of what’s necessary was already done in prevoius steps! Two simple steps and you are there: While in the Terminal prompt this command: . This will start a virtual server. $ npm start Go to the address bar of your internet browser and type . Localhost is a top-level-domain (TLD) just like or . However, it’s reserved for documentation and testing purpose. With you call the default port to access the newly build server. localhost:3000 .com .org :3000 Welcome screen on your local server once the Express app is running Where to go from here Congrats! You have created your first app and actually run it on your own server. From here you could start building your custom app. The app skeleton is already setup in a way that allows you to build your site within the index.ejs. In case you like to build anything more advanced than a simple site you should consider using partials. It means that you build your app in components that you can reference from your index.ejs. Conveniently, we have already installed the view engine EJS that will help you while building specific parts of your app in components. Thank you for reading this far. I really hope you found this tutorial helpful. Please share, comment, and press/hold that 👏 a few times (up to 50 times). I like to keep doing these tutorials if there is interest from you!
