Page tree
Skip to end of metadata
Go to start of metadata

Overview

This document describes how to install the Jekyll web application. The Jekyll application is a static website generator that functions on the Ruby platform

Warnings:

  • cPanel Technical Support does not provide assistance with the steps in this document.
  • We recommend that only experienced system administrators perform these steps.
  • We are not responsible for any data loss.

Notes:

  • We recommend that you perform the steps in this document via the command line as a cPanel user unless otherwise specified.
  • You can also perform these steps in cPanel's Terminal interface (cPanel >> Home >> Advanced >> Terminal) in cPanel & WHM version 72 and later.
  • You do not need to register the Jekyll application's configurations in cPanel's Application Manager interface (cPanel >> Home >> Software >> Application Manager).
  • In this document, hyde represents the application's name.


For more information, read Jekyll's documentation.

Install Jekyll


Pre-installation settings.

Before you begin, make certain that the following EasyApache 4 RPMs exist on your server:

If you need to install these RPMs, run the following command as the root user:

yum install ea-ruby24-mod_passenger ea-ruby24-ruby-devel




Install the bundler and jekyll gems.

To install the bundler and jekyllRuby gems, run the following command as a cPanel user:

scl enable ea-ruby24 'gem install bundler jekyll'

If you do not wish to use the scl utility, perform the following steps to install the bundler Ruby gem:

  1. Log in to the server as a cPanel user.

  2. Add the following line to your shell's rc file (for example, /home/user/.bashrc file):

    source /opt/cpanel/ea-ruby24/enable
  3. Log out of your terminal session, and log back in again.

    Note:

    You can also create an additional terminal session.

  4. Run the gem install bundler jekyll commands.

 


 

Create your jekyll website.

After you install the bundler and jekyll Ruby gems, create your application. To do this, run the following command in your current directory:

scl enable ea-ruby24 'jekyll new hyde'

 


 

Build and deploy the application.

After you create the application, build the application and deploy it. To do this, change to the /hyde directory and run the following command:

scl enable ea-ruby24 'jekyll build --baseurl '/hyde' --destination ~/public_html/hyde'

 After you run this command, navigate to the new site in a web browser with the following url:

http://example.com/hyde

Note:

In this example, example.com represents your website.

Additional documentation