Jekyll Setup Guide

As of now, this guide will only cover commands that are specific to linux environment since i used Ubuntu in creating this guide.

Initial Project Setup

1. Install curl

sudo apt install curl

2. With curl, you can now install node.js

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs

3. You will need ruby to run jekyll

sudo apt-get install ruby-full

4. With these, you may install jekyll finally

gem install jekyll bundler

5. Now create your jekyll project

jekyll new my-awesome-site

6. Finally, we start our server

bundle exec jekyll serve

Some Extras

Here I cover some other stuff about installing brackets editor or if you encountered some of the issues I had or just want to install a plugin.

a. If you like to use Brackets code editor

sudo apt-get install brackets

b. Wanna install github-pages?

#Copy and paste in gem file


source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins

#Then run bundle install in the command line

c. Getting some damn errors?

sudo apt-get update
sudo apt-get install zlib1g-dev
sudo gem install nokogiri
bundle update

d. Some jekyll commands for building

$ jekyll build
# => The current folder will be generated into ./_site


$ jekyll build --destination <destination>
# => The current folder will be generated into <destination>


$ jekyll build --source <source> --destination <destination>
# => The <source> folder will be generated into <destination>


$ jekyll build --watch
# => The current folder will be generated into ./_site,

# watched for changes, and regenerated automatically.


$ jekyll serve
# => A development server will run at http://localhost:4000/

# Auto-regeneration: enabled. Use `--no-watch` to disable.


$ jekyll serve --detach
# => Same as `jekyll serve` but will detach from the current terminal.

# If you need to kill the server, you can `kill -9 1234` where "1234" is the PID.

# If you cannot find the PID, then do, `ps aux | grep jekyll` and kill the instance.


$ jekyll serve --no-watch
# => Same as `jekyll serve` but will not watch for changes.

e. If you forgot your commands, you may want to install jekyll docs

# Install the gem

sudo gem install jekyll-docs

# To launch the docs

bundle serve jekyll docs

# need to add in Gemfile

gem 'jekyll-docs'

f. If you do not have the latest ruby (e.g. 2.4.X)

\curl -sSL https://get.rvm.io | bash -s stable

rvm list known

rvm install ruby-2.4.2