Blogging to the max : Migrating from WordPress to Azure static web apps + Hugo

I have started blogging few months back and as everyone did ,I went ahead and created my blogs using WordPress. As days goes by I had this thought of optimizing cost of blogging , as we do this without expecting anything in return. All I used in WordPress were static contents and I had no need of dynamic events to occur in my Blog. So I wrote down a list of features for which I’m paying WordPress and tried to see how to reduce it.


Eventually they charge us on these below 3 components.

  • DB
  • Hosting
  • Maintenance

These days we were paying WordPress for the above 3 components for no use. The reason I say it is of no use is , since I don’t even need to make a service call to DB to fetch my contents and I can drastically reduce latency by migrating my site to Static Page. So we solved our first problem where we don’t need to spend cost over DB and it’s maintenance.

Next comes Hosting , recently Microsoft announced General availability of Azure Static Web Apps for Azure Static Web Apps where you can host your static website with free SSL Certificate with backend support ( Azure Functions ) for $0 !. Isn’t that a great news?! :) .

Finally Maintenance of our site is also covered by our cloud Provider (Microsoft Azure) for free of cost.


Pricing Azure Static Web App WordPress
Hosting Free ₹320 monthly
Themes Free Free/Paid
SSL Free Need to Buy Domain
Speed Fast Depends on the plan

It is a service provided by Microsoft Azure ,with which developers can use modular and extensible patterns to deploy apps in minutes while taking advantage of the built-in scaling and cost-savings offered by Serverless technologies.

Pre-rendering static content (including HTML, CSS, JavaScript, and image files) and leveraging global content distribution to serve this content removes the need for traditional web servers generating the content with every request. Moving dynamic logic to Serverless APIs unlocks dynamic scale that can adjust to demand in real time and can empower developers to access the benefits of microservices as they evolve and extend individual app components. The service is designed for developers using frameworks like Angular, React, Svelte, and Vue or static site generators like Hugo looking for a simple interface to deploy the cloud resources.


  • Globally distributed content for production apps
  • Tailored CI/CD workflows from code to cloud
  • Auto-provisioned preview environments
  • Custom domain configuration and free SSL certificates
  • Built-in access to a variety of authentication providers
  • Route-based authorization
  • Custom routing
  • Integration with Serverless APIs powered by Azure Functions
  • A custom Visual Studio Code developer extension
  • A feature-rich CLI for local development

Now that we have decided to host our contents statically , we need to somehow need a editor and a plugin/framework that helps in rendering our markdown to static contents in our site.

So I chose Hugo to generate my static contents . It’s a tool which combines a bunch of files and turns them into HTML, CSS and JavaScript files. Or in other words it uses these files to generate a static site.

Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again

Now Let’s see the main part on how to migrate our existing blogs to Hugo with the help of Azure Static Web Apps.


Download this repo https://github.com/SchumacherFM/wordpress-to-hugo-exporter as a Zip folder so that it can be imported to WordPress Plugins

or use below command

1
curl -L https://github.com/SchumacherFM/wordpress-to-hugo-exporter/archive/master.zip

Now go to your WordPress Site and follow below steps

  1. In the plugin section, go to Add New.

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/s8cfzo7dfy484a437vla.png

  1. Upload the zip of this repo.

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/eks5miygt8xbyly8hszk.png

  1. Activate the plugin.

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/tz04vy0xl68sjke4qu99.png

  1. Run the Export to Hugo command.

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/jquzcjmmiymc93agbo1v.png

  1. Zip folder of whole site is downloaded to your local computer.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
|   config.yaml
|   output.doc
|   output.txt
|   
+---posts
|       2021-05-23-hello-world.md
|       
+---privacy-policy
|       index.md
|       
\---sample-page
        index.md

In this blog I have covered how to work with Hugo in Windows OS , For other environments please visit Official Website

Windows Installation

  1. Download Hugo latest release from Hugo repository , Latest release as of date this blog published is 0.83.1 https://github.com/gohugoio/hugo/releases/tag/v0.83.1.

  2. Create folder named “Hugo” under your C: Directory.

  3. Now create “Bin” and place your extracted Hugo.exe under this folder.

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/qpedrnvnhqv6g60xkuqd.png

4.Create Environment Variable for Hugo with the above path

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rghrvahp9k82l61tihxi.png

Chose theme for your Blog

  1. Run below command to create a new Hugo site
1
hugo new site demoblog

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/bkqts5blwut8240y1noq.png

  1. You will be having below folder structure after executing the above command
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
|   config.toml
|   output.doc
|   output.txt
|   
+---archetypes
|       default.md
|       
+---content
+---data
+---layouts
+---static
\---themes
  1. Go to https://themes.gohugo.io/ for list of themes available for free. Choose your favorite theme , For this demo I’m gonna use https://github.com/zwbetz-gh/papercss-hugo-theme theme .

  2. Now run the below command

1
2
3
cd demoblog 
git init 
git submodule add https://github.com/zwbetz-gh/papercss-hugo-theme.git themes/paper

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ayasv5eja91j8d5y0e0g.png

Now copy all the posts that are extracted from your WordPress zip folder and paste it under Contents/Posts folder of newly created Hugo site

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/f5wfoitk056ds81dbnxb.png

  1. Now copy below content to config.toml
1
2
3
4
baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "paper"
  1. Now open the .md files that you extracted to content/posts folder and replace top portion like below
1
2
3
4
5
author: Divakar
date: 2021-05-23T14:55:50+00:00
linktitle: Hello world!
title: Hello world!
weight: 10

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/szew9lr7t06pqmov0yun.png

  1. After modifying the content , run below command to execute Hugo site locally
1
hugo server -D

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/1boiy4n07ebf6in2lj7c.png

  1. We will use GitHub Actions to push our contents to Azure Static Web App . Run below command to commit our changes
1
2
git add -A
git commit -m "initial commit"
  1. Now create Blank Github Repo from https://github.com/new named demoblog.

  2. Add the github repo as remote to your local repo.

1
2
3
git branch -M main
git remote add origin https://github.com/Divakar-kumar/demoblog.git
git push -u origin main

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/4f95t64gsqsu4jusl0fm.png

  1. Go to Azure portal

  2. Search for Static Web Apps and click on create

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/dg8aqmsy8npuxpf25ev2.png

  1. Based on your subscription and resource group , enter the following values
Property value
Subscription choose azure subscription name
Resource Group choose your resource group
Name Name for your hugo site
Plan Type Free
Source GitHub

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/cjhgfytol4qwrvuu274j.png

  1. Choose respective organization -> repository -> branch of your Hugo site

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/h0x5trm4h5cor1opau6r.png

  1. Select Review + create button to verify all information and after validation you will be prompted with Create button , it allows azure to start the creation of Azure Static WebApp and provision a GitHub Action for deployment

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/wg5nfbxy6ro5rs0fkurz.png

  1. Now go to your GitHub repository where you will find GitHub Action deployment is triggered , once it is completed you will be able to see your live blog running for $0

https://dev-to-uploads.s3.amazonaws.com/uploads/articles/jri0mn9lr1yjdvih3chb.png

  1. Whenever you push changes to your repo ,GitHub deployment will be automatically triggered and your contents get published to Azure Static Web App.

Find my GitHub repo for this demoblog : https://github.com/Divakar-kumar/demoblog

My Live url : https://iamdivakarkumar.com/

My Default Azure Static Web App Site : https://lively-ground-014d6c510.azurestaticapps.net/


  • What is Azure Static Web Apps and it’s features
  • Hugo - Static Site Generator
  • How to migrate WordPress blogs to Static Site
  • Deployment of Hugo site to Azure Static Web App

In further blogs will show how to customize hugo themes as I did for my blog and learn about how to monetize Hugo site