Jekyll QuickStart

Host on GitHub in 3 Minutes

Make sure to input your GitHub username so the instructions reflect the exact code you need to run to host your blog.

1. Create a New Repository

Go to your and create a new repository named

2. Install Jekyll-Bootstrap

Enter these commands into your terminal in a directory you want your blog to be:

3. Profit

After GitHub has a couple minutes to do its magic your blog will be publicly available at

Already have your blog on GitHub?

I'll assume you have the Jekyll gem installed on your local machine. Run Jekyll-Bootstrap locally to see what all the fuss is about:

$ git clone
$ cd jekyll-bootstrap
$ jekyll serve

See it in action at http://localhost:4000.

2. Run Jekyll Locally

In order to preview your blog locally you'll need to install the Jekyll ruby gem. Note gem dependencies will also be installed. You don't have to run a local version but it helps if you want to preview your content before publishing.

$ gem install jekyll

If you run into a problem please consult the original Jekyll installation documentation. You can also create a support issue using GitHub Issues.

Once the gem is installed you can navigate to your Jekyll-Bootstrap directory. If you've followed the homepage instructions this will be: Once in the directory you'll run jekyll with server support:

remember to change USERNAME to your GitHub username.

$ cd 
$ jekyll serve

Your blog is now available at: http://localhost:4000/.

3. Create a Post

Create posts easily via rake task:

$ rake post title="Hello World"

The rake task automatically creates a file with properly formatted filename and YAML Front Matter. Make sure to specify your own title. By default, the date is the current date.

The rake task will never overwrite existing posts unless you tell it to.

4. Create a Page

Create pages easily via rake task:

$ rake page name=""

Create a nested page:

$ rake page name="pages/"

Create a page with a "pretty" path:

$ rake page name="pages/about"
# this will create the file: ./pages/about/index.html

The rake task automatically creates a page file with properly formatted filename and YAML Front Matter as well as includes the Jekyll Bootstrap "setup" file.

5. Publish

After you've added posts or made changes to your theme or other files, simply commit them to your git repo and push the commits up to GitHub.

$ git add .
$ git commit -m "Add new content"
$ git push origin master

A GitHub post-commit hook will automatically deploy your changes to your hosted blog. You will receive a success or failure notice for every commit you make to your blog.

6. Customize

Jekyll-Bootstrap can be used as-is as a basic blogging platform. However there are plenty of ways to dig into deeper customization. The following outlines deeper Jekyll-Bootstrap customization techniques:


Jekyll-Bootstrap supports modular theming. Themes can co-exist and be enabled/disabled on demand. Editing, configuring, and creating themes is docummented in the Theming section.

Blog Configuration

Jekyll and Jekyll-Bootstrap has a simple but powerful Jekyll Configuration System. You can:

  • Specify a custom permalink format for blog posts.
  • Specify a commenting engine like disqus, intensedebate, livefyre, or custom.
  • Specify an analytics engine like google, getclicky, or custom.

Programming Interface

The API pages document main data-structures and code available for use in Jekyll and Jekyll-Bootstrap. Consult these pages for how and where to use the data and code provided.

Jekyll Introduction

Highly Recommend

I highly recommend reading the Jekyll Introduction if you plan to customize your blog. The introduction is meant for core understanding of how and why Jekyll works the way it does. This will provide you with the proper context, knowledge-base, and fundamentals necessary to understand and be efficient in working with Jekyll and Jekyll-Bootstrap.