Information: This page is using Temporary URL, I will move this page to Tutorial section later.


In 2016 I wrote two articles: installing Jekyll in Debian, and installing Jekyll in Arch/Manjaro. Now that I use openSUSE, I also write the third article.

There are two approaches for openSUSE,

  • System Wide: Install gem as root with Ruby provided by openSUSE

  • Local RVM: Install gem in user space with RVM (Ruby Version Manager)

You can click images for complete screenshot.

System Wide

This article is short, compared with Debian or Arch. It is incredibly easy to run Jekyll on openSUSE.

Install Required Ruby Package

% sudo zypper in ruby-devel

Install Jekyll via Gem

Do not forget to use sudo, and also install optional package.

% sudo gem install jekyll
% gem list
% sudo gem install jekyll-paginate

Tumbleweed: sudo gem install jekyll

Run jekyll

Since I already has my own blog, I can change directory and just run this jekyll blog server.

% cd ~/
% /usr/lib64/ruby/gems/2.4.0/gems/jekyll-3.7.0/exe/jekyll -h

Tumbleweed: Ruby Long Path

Set Path

For convenience, In .bashrc or .zshrc, so we do not need to remember jekyll path.

export PATH=${PATH}:/usr/lib64/ruby/gems/2.4.0/gems/jekyll-3.7.0/exe

Tumbleweed: Setting Path in .bashrc or .zshrc

For convenience, we can also make an alias.

alias jekyll-blog='jekyll serve --config _config.yml,_config_dev.yml'

And run with very simple command.

% jekyll-blog

Local RVM

For some reasons, it is good to run Ruby outside root. Don’t ask me why, I’m a n00b in Ruby.


This is a must read link before you start RVM.


Development Tools

% sudo zypper in ruby-devel


% sudo zypper in patch automake bison libtool m4 patch gdbm-devel libffi-devel libopenssl-devel readline-devel sqlite3-devel libyaml-devel

And this rpm downloaded

% sudo zypper in ~/Downloads/libdb-4_5-4.5.20-134.14.x86_64.rpm

RVM: System Dependencies

Install RVM

% \curl -sSL | bash -s stable --ruby 

RVM: Install: Start

RVM: Install: Finish

Setup RVM

% source ~/.rvm/scripts/rvm

% list known

% rvminstall 2.4

% rvm --default use 2.4.1

% ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]

% which ruby

Install Gem

% source ~/.rvm/scripts/rvm
% gem install jekyll

RVM: gem install jekyll

Do not forget any optional dependencies.

% gem install jekyll-paginate

Now you have these path for Jekyll.

  • ~/.rvm/gems/ruby-2.4.1/gems/jekyll-3.7.0/exe/jekyll

  • ~/.rvm/gems/ruby-2.4.1/bin/jekyll

Running Jekyll

For convenience, add these lines to .bashrc or .zshrc.

export PATH=${PATH}:~/.rvm/gems/ruby-2.4.1/bin/
source ~/.rvm/scripts/rvm
alias jekyll-blog='jekyll serve --config _config.yml,_config_dev.yml'

RVM: .bashrc or .zshrc

Now we can run jekyll with either of these three

% ~/.rvm/gems/ruby-2.4.1/gems/jekyll-3.7.0/exe/jekyll serve --config _config.yml,_config_dev.yml

% ~/.rvm/gems/ruby-2.4.1/bin/jekyll serve --config _config.yml,_config_dev.yml

% jekyll-blog

RVM: Running Jekyll

If you desire some details, you may refer to my old post about

Thank you for reading.