Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
  Website Based on Jekyll

Getting Started

These instructions will get you a copy of the website up and running on your local machine for development and testing purposes.


Jekyll static site generator docs.

  1. Install a full Ruby development environment

  2. Install Jekyll and bundler gems

     gem install jekyll bundler
  3. Fork the project repository, then clone your fork.

     git clone
  4. Change into the project directory:

  5. Use bundler to fetch all required gems in their respective versions

     bundle install
  6. Build the site and make it available on a local server

     bundle exec jekyll serve
  7. Now browse to http://localhost:4000

If you encounter any unexpected errors during the above, please refer to the troubleshooting page or the requirements page, as you might be missing development headers or other prerequisites.

For more regarding the use of Jekyll, please refer to the Jekyll Step by Step Tutorial.

Building the documentation

Documentation of SmallRye projects is built separately, because it's not using Jekyll. Instead, it's using Antora.

  1. Install Antora. See Antora installation.

  2. Go to the docs directory and run

    antora generate antora-playbook.yml --fetch

  3. Now you should have the html files for SmallRye documentation in the docs/build/site directory. Make sure you're viewing these files directly rather than through Jekyll - explanation is in the following paragraph.

There is a caveat in using Antora together with GitHub Pages, because GitHub Pages runs all files in the repository through Jekyll, which breaks Antora's directory structure. To prevent this, before committing the documentation site to a GitHub Pages repository, create an empty file named .nojekyll in the root of the repository. See Antora documentation for more information.


Please refer to our Wiki for the Contribution Guidelines.


This website is licensed under the Creative Commons Attribution 3.0.