Setting up Hexo on Windows

Follow these instructions to install and configure the Hexo blog framework on Windows.

Requirements

• Git Bash

1. Install Node.js

1. Install Node.js

   

2. Make sure to allow Node.js Windows Firewall access.

   

3. Verify the installation by running the following commands inside the Git Bash:

   node -v
   npm -v
   

2a. Re-install hexo

For those re-installing Hexo from an existing hexo blog repository:

1. Do NOT create the directory described step 1 but checkout your blog repo instead
2. Cd into your repo directory and git checkout the source branch
3. Continue with step 2 below but SKIP the hexo init command

2b. Install Fresh Hexo

Please note that all commands are to be executed within the Git Bash.

1. Create a new directory that will hold your blog

   mkdir myblog
   cd myblog
   

2. Install the hexo framework and the git deployer

   npm install hexo-cli -g
   npm install hexo-deployer-git --save
   hexo -v
   

3. Initialize your blog

   hexo init
   npm install
   hexo serve
   

4. Now browse to http://localhost:4000 and enjoy your first blog

5. You're good to go, next steps would be:

   • Customizing _config.yml to your likings
   • Creating your first post by running hexo new

3. Deploy

The hexo git deployer has taken all the hard work out of deploying your blog to your master repo.

1. First load your Github private key inside the Git Bash

   eval `ssh-agent`
   ssh-add ~/.ssh/github_rsa_key
   

2. Now simply generate and deploy your blog

   hexo generate -d
   

4. Save Local Changes

Do not forget to save your local changes by commit pushing them to the source branch of your central repository.