How to set up a static Hugo website on GitHub pages in 2 minutes

· by Göran Svensson · Read in about 3 min · (460 Words)

A static website - appernetic.io

A static website is fast and secure but it is not easy to set up a new blog or website if you don’t know a lot of commands, tools and also how to install them when you would rather like to be writing exciting content to distribute over the interwebz!

First,​ you have to:

  • download the right version of the static website generator for your OS and architecture.
  • install git
  • create a GitHub, Bitbucket, Dropbox or Amazon S3 account or set-up a web server with a web Host.

Then when the installation and configuration are ready there are lots of steps to just have the website up and running on the Interwebz.

Before I created Appernetic I had to do all these 15 steps in the terminal after installation and configuration :

hugo new site blog 
cd blog
hugo new post/easy-peasy.MD

Then open the file in a text editor and write content, then dive back in to terminal:

mkdir themes 
cd themes 
git clone https://github.com/appernetic/hugo-bootstrap.git
hugo undraft content/post/easy-peasy.md
hugo --theme=hugo-bootstrap
mkdir blog-public
cd blog-public
git init
git remote add origin https://easypeasy:[email protected]/easypeasy
cp -r ../blog/public/ .
git add --all
git commit -am ”Publish site”
git push origin master

You have just published your first blog! Check your live server at:

 http://easypeasy.github.io (do not click this is just an example)

All these 15 steps will take at least 30 min if you have the knowledge. Now we do the same with Appernetic.

We assume the following is already done:

  1. You have signed up for a subscription.
  2. You have created a GitHub account.

Now watch this instructive how-to video for 2:13 minutes.

What about custom domains?

No problem, it is easy to connect your custom domain to your GitHub Pages. Follow these five steps (no programming or terminal console needed):

  1. In your Appernetic dashboard, Sync you appernetic project with GitHub, this will create a appernetic-hugo-project with all your files on GitHub. We do this so that we can work with files outside the content folder.
  2. Place this file in your GitHub, appernetic-hugo-project repositories static folder: Filename: CNAME

    blog.easypeasy.com Here you can see how we did this.

  3. Sync your project again in your Appernetic Dashboard.

  4. Publish your blog (if you have something un-drafted to publish). Now your CNAME file also lives in the compiled GitHub Pages site.

  5. Now the last step is to make it work over the Internet. For this, you have to make a CNAME record in your DNS or your service providers DNS and wait for everything to propagate (give it 8 to 24 hours). Read more: using a custom domain with GitHub pages.

That’s it! Give fast, secure blogging a try and you will never go back to WordPress, Joomla or Drupal. We support you both in Swedish and English.