Install Hexo nodejs blog on Windows 10 with Github features for testing

Hexo is a simple and lightweight blog framework that can be installed using Nodejs NPM commands in a few minutes. Nodejs powered Hexo blog uses Markdown, a lightweight markup language with plain text formatting syntax to write posts; which further generated as static files and publish on the blog under the installed Hexo theme. The main attribute of Hexo is its capability to generate Gitbub blog pages; it means after installing the Hexo locally you can push your blog from Hex to Github pages directly which can be accessed using the subdomain of your created under the domain

However, here we will only discuss how to install Hexo blog using NodeJS NPM on WIndows 10 for learning, developing and testing purposes… The process of HExo installation will be the same for Ubuntu Linux the only difference will be the process of nod.js installation.

Requirements to install Hexo Blog

  • Node.js (at least nodejs 6.9 version)
  • Git

Step 1: Install NodeJS+NPM on Windows 10/8/7

NodeJs is available in executable binary form for Windows, visit the official website to get it, for your convenience here is the download page link of NodefJS. Select the NodeJS LTS version for Windows LTS and download it.

Run the downloaded setup and follow the installation wizard, in few seconds NPM and Node both will be on your system.

Install NodeJS+NPM on Windows 10

Step 2: Install Git on Windows 10/7

As mentioned above besides the Nodejs another requirement of Hexo is the Git, thus visit the official download page of Git and download the Windows version of the same. Once you get it to install, the process will be like any other Windows program.

Step 3: Install Hexo blog using NPM

Open Command prompt on your respective Windows OS version and after that run the following given command to instal Hexo on Windows.

npm install -g hexo-cli

Install Hexo blog using NPM

Step 4: Clone Hexo blog files

Now, in this step, we will clone the Hexo core files from the Github repository to our local system under a folder called blog. Thus, use type the given command and press the Enter button.

hexo init blog

Clone Hexo blog files locally on Windows

Step 5: Switch to the blog directory

In the above step, we have cloned the hexo file under a directory called a blog, now use CD command and switch to that particular directory.

cd blog
npm install

Step 6: Run the Hexo Server

Finally, everything is ready on our Windows operating system and its time to run the hexo server command to view our blog in the browser under the localhost URL with a port 4000.

hexo server

The output will show the URL which we can use to view the front of the blog, however, don’t try to use Ctrl+C keyboard shortcut to copy the displayed URL, it will stop the server. In lieu of that simply type:


Run server

Hexo blog interface

Download Hexo theme from Github and install

You can configure different aspects of Hexo blog directly by visiting the installation folder. In our case, it was under folder blog.

Here, we want to install some new theme, for that first, we go to hexo installed folder to access the  Theme folder.

blog directory

Simply download the Hexo theme from Github which you want to implement and after that copy it to the Themes folder of the Hexo blog.

Afterwards, Open the _config.yml file, present in main direcotry of hexo and find the line:

theme - landscape

Replace the default theme name landscape with the one you have downloaded, I mean just replace it with the folder name of your new theme present in Hexo themes folder.

We have download a theme called 3-Hexo, thus we modified the code as:

theme -  3-hexo

Now, stop and restart the Hexo server.

When this time you refresh your blog you will see your newly installed theme.

Here is our afresh implemented them which 3-hexo; a 3 column theme.

Hexo blog powered by nodejs on WIndows 10 theme

Other Tutorials to read: