# How to Create Your Own Blog 100% for Free
I was tired of the Facebook echo chamber and the Instagram vanity mirror and missed the glory days of Myspace and the blogosphere. So I decided to quit Facebook and make my own blog. In my last post to Facebook, I declared you can create a blog 100% for free and I promised myself that one of my first blog posts would be how to do so.
So here we are. There are a few requirements that I needed for my blog, which is why I settled on using Vuepress (opens new window). I came up with these requirements by working backwards from what I would want in an ideal blogging solution.
- Everything must be free.
- Blog posts should be created as easily as committing a markdown file.
- My blog should be extensible with Vue (opens new window).
Vuepress seems to meet all of these requirements so I decided to just use it out of the box. If you are familiar with Github, you can copy my blog to start your own here (opens new window).
Otherwise, I'm going to cover the general instructions to set up your own blog, without going too deeply in the specifics.
# Creating your first Vuepress site
To start, I basically just followed the excellent guide I found here (opens new window). It does a great job introducing you to Vuepress enough for you to begin customizing your blog yourself. It says you should have a blog up and running in around 10 minutes, but I think that's a little generous.
Still, it goes over everything you really need to know and it shouldn't take you too long to get set up. It then barely goes over how to deploy your blog as a website, so that is the step I will cover in more detail next.
# Using Github pages to host your blog for free
The gist of how this works is as follows: You will use Github to host the source code of your blog for you. Github offers a feature called Github pages (opens new window), which we will then utilize to turn your source code into a real website.
The way this works is that you build your website from the source code, which generates the output in a folder called
dist. You then upload that folder to github on a special
gh-pages branch, which is how Github pages knows where to find your static site (basically the end product, or the final html file that is your entire blog). This site is now available for the world wide web to access thru a url like mywebsite.github.io/blog. If you want to spend money on your site, you can buy a domain name via GoDaddy (opens new window) or Google Domains (opens new window) to have your mywebsite.github.io/blog url redirect to a cooler name like myadventures.blog. You can get domains for pretty cheap. (My christofer.rocks domain was only $15 for 1 year.)
Ok. If you're still with me, here's how to do it.
- Create a Github (opens new window) account.
- Host your code in a new repository (opens new window).
- Go to your repository settings. For example, mine is at https://github.com/cpadilla/christofer-rocks/settings (opens new window), although you obviously can't access my settings; your url should be something similar.
- Scroll down to the Github Pages settings. Under source, you want to change the branch dropdown to
- Follow the steps on the official Vuepress documentation (opens new window) page on deploying to GitHub pages. You pretty much just need to create the following shell script and run it.
#!/usr/bin/env sh # abort on errors set -e # build npm run docs:build # navigate into the build output directory cd docs/.vuepress/dist # if you are deploying to a custom domain # echo 'www.example.com' > CNAME git init git add -A git commit -m 'deploy' # if you are deploying to https://<USERNAME>.github.io # git push -f firstname.lastname@example.org:<USERNAME>/<USERNAME>.github.io.git master # if you are deploying to https://<USERNAME>.github.io/<REPO> # git push -f email@example.com:<USERNAME>/<REPO>.git master:gh-pages cd -
That's all there is to it! It's not that bad at all and now creating blog posts is as easy as creating a new markdown file and deploying it. Keep in mind that what is deployed in the
gh-pages repo doesn't necessarily match up with what you commit to your main github repo that contains the source code.
Finally, if you do decide to spend money and obtain a custom domain, you can follow these (opens new window) steps to redirect your GitHub page to your new domain. Don't forget to uncomment out the relevant line in your deploy script!
Hopefully, this guide will help you create your own blog and stake your claim in internet territory without the need of social media platforms. This is great because not only can you host all types of media, but you can also use Vue and HTML to create and share unique components as well such as panoramas, tweets and other widgets. It's truly the wild west of the web!