Jekyll Github-pages locally in Ubuntu 22.04

I’m an enthusiastic admirer of Jekyll, which I use for all my static websites and this blog. The official GitHub documentation doesn’t help much as a guide to running Jekyll on my local machine. Here is how to run it in Ubuntu 22.04.

1. Install Ruby.

sudo apt install ruby-full

2. Configure gems to ne stored in user home folder. For bash use .bashrc (for zsh, we would use .zshrc)

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

3. Install Bundler

gem install bundler

4. You need to have a Gemfile in your website root folder to continue, here is mine as an example.

source "https://rubygems.org"
git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
gem "github-pages"
gem "jekyll"
gem "jekyll-theme-architect"
gem "webrick", "~> 1.7"

4. Install dependencies.

bundle install

5. Run the server.

bundle exec jekyll serve