Jekyll installation guide
Table of contents
Requirements
- Ruby >= 2.7.0
$ ruby -v
- RubyGems
$ gem -v
- GCC and Make
$ gcc -v
$ g++ -v
$ make -v
Jekyll on Ubuntu/Linux Mint
Install a full Ruby development environment
$ sudo apt update
$ sudo apt install ruby-full build-essential zlib1g-dev
$ echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
$ echo 'export PATH="$PATH:$HOME/gems/bin"' >> ~/.bashrc
$ source ~/.bashrc
Install Jekyll and Bundler gems
$ gem install jekyll bundler
Create a new Jekyll site at ./myblog
$ jekyll new myblog
Change into your new directory
$ cd myblog
Build the site and make it available on a local server
$ bundle exec jekyll serve
If you’re using Ruby version 3.0.0 or higher, this step may fail. You may fix it by adding webrick to your dependencies: bundle add webrick.
Now browse to http://localhost:4000
Run this command to update installed gems
$ bundle update
Jekyll on Arch Linux
Install a full Ruby development environment
$ sudo pacman -Syy
$ sudo pacman -S ruby
$ echo 'export GEM_HOME="$HOME/.gem"' >> ~/.bashrc
$ echo "export PATH=\"\$PATH:\$(ruby -e 'print Gem.user_dir')/bin\"" >> ~/.bashrc
$ source ~/.bashrc
Before installing Jekyll make sure to update RubyGems
$ gem update
Install Jekyll and Bundler gems
$ gem install jekyll bundler
Create a new Jekyll site at ./myblog
$ jekyll new myblog
Change into your new directory
$ cd myblog
Build the site and make it available on a local server
$ bundle exec jekyll serve
If you’re using Ruby version 3.0.0 or higher, this step may fail. You may fix it by adding webrick to your dependencies: bundle add webrick.
Now browse to http://localhost:4000
Run this command to update installed gems
$ bundle update