This is how I installed Jekyll on Windows 10 using two approaches:


  1. Jekyll requires Ruby to run
  2. GitHub Pages can host Jekyll sites
  3. This blog is hosted on GitHub Pages

The official instructions are found here:


This approach runs Jekyll directly on your Windows operating system.

Open a command prompt as Administrator.

Install Chocolatey:

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString(''))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"


Install Ruby:

choco install ruby


Open a new command prompt, so that changes to the PATH environment variable becomes effective.

Install Jekyll:

gem install bundler jekyll

Install Gems:

bundle install

Build and serve the site:

bundle exec jekyll serve

bundle exec jekyll serve


This approach runs Jekyll in a Linux container with Docker using the image:

Download and install: Docker for Windows

Share your local drives (volumes) with Docker for Windows, so that they are available to your Linux containers: Shared drives

Open a command prompt.

Build and serve the site with docker run:

docker run -t --rm -v %CD%:/usr/src/app -p 4000:4000 starefossen/github-pages

Or build and serve the site with docker-compose:

docker-compose up

using this docker-compose.yml file:

docker-compose up


Get errors when switching between the Chocolatey and Docker approach? Try to delete the Gemfile.lock file!

Get errors like driver failed programming external connectivity on endpoint with Docker? Try to restart Docker for Windows!