Running Jekyll on Docker

I will share my experience using jekyll with Github Pages, since I use windows is kind of dificult to me to have an localhost environment running Jekyll to se your blog with your eyes on your machine.

But, we have Docker now, a magical containering tool to have you running apps quickly, so this is the guide I follow to have running my repository of my Jekyll project using docker.

Requirements

• docker
• console screen
• jekyll project
• git

Prepare your code

First, we need your code in a folder, this will be your root path, the place we will run docker jekyll container

cd my_project_path

Now we will be ready, on this path you will add a new file a docker-compose.yml

Compose docker file

This new file will have your container environment running, so copy this content to the file

version: '3'
services:
  jekyll:
    image: starefossen/github-pages
    environment:
      - "JEKYLL_GITHUB_TOKEN:${JEKYLL_GITHUB_TOKEN}"
    ports:
      - "4000:4000"
    volumes:
      - ./:/usr/src/app
    tty: true

Running up your jekyll project

Now you need to run in your root folder this next command, the commmand that will get up and running your localhost environment

docker-compose up

next you will see an screen like this if everithing runs correctly

Finally, you need to go to this address in your browser to see your app running 🙂

http://localhost:4000/

I hope this helps you to save time and keep things running faster as I am do now