This guide walks you through creating your own website (much like this one) using ruby, the Jekyll framework and the al-folio theme. Enjoy!

  • OS: Ubuntu 22.04.1 LTS

Update the apt package manager

sudo apt update && upgrade -y

Install a Ruby version manager for this project

sudo apt install rbenv
rbenv init

reload or restart the shell

source ~/.bashrc on ubuntu or source ~/.zshrc on Mac OS

install ruby-build for a simplified ruby installation as an rbenv plugin

git clone "$(rbenv root)"/plugins/ruby-build
git -C "$(rbenv root)"/plugins/ruby-build pull

install your prefered Ruby version (I used 3.1.2):

rbenv install X.X.X

Set a Ruby version to finish and start using Ruby

rbenv global 3.1.2   # set the default Ruby version for this machine
# or:
rbenv local 3.1.2    # set the Ruby version for this directory

Install the bundler gem

gem install bundler

Fork the Jekyll theme from to

build your theme

cd <your-repo-name>
bundle install
bundle exec jekyll serve

Customize the theme (e.g. using VS Code)

code .

  • Tip: You can navigate to to see your portfolio. Refresh to see changes.


  1. rbenv README
  2. ruby-build README
  3. al-folio README