How to Create Ruby Web Applications

Last modified: July 25, 2022

Overview

Warning:

In cPanel & WHM version 66, we deprecated the legacy Ruby codebase and plan to remove it in a future release. This legacy Ruby codebase includes Ruby on Rails applications. We will not support any applications you create with the following interfaces:

cPanel’s Ruby on Rails interface (cPanel >> Home >> Software >> Ruby on Rails).
cPanel’s RubyGems interface (cPanel >> Home >> Software >> RubyGems).
The Ruby Gem installer feature in WHM’s Module Installers interface (WHM >> Home >> Software >> Module Installers).

This document describes how to create and install Ruby web applications in cPanel & WHM version 66 and later that function on the Phusion Passenger® platform.

Note:

To use this feature, the cPanel account must possess compiler access in WHM’s Compiler Access interface (WHM >> Home >> Security Center >> Compiler Access). If the account does not possess compiler access, the system will return an error similar to the following message:

make: execvp: gcc: Permission denied

Create a Ruby application

To install a Ruby application in cPanel & WHM version 66 and later, perform the following steps:

Install Ruby on your system. To do this, install the ea-ruby27-mod_passenger module in the Ruby via Passenger section of the EasyApache 4 interface (WHM >> Home >> Software >> EasyApache 4).
Note:
If you wish to add environment variables to your application, install the following additional RPMs:
- The ea-apache24-mod_env module.
- The ea-ruby27-ruby-devel module.

For more information about environment variables, read cPanel’s Application Manager documentation.

Create a Ruby web application on your server. For examples of web applications that you can create, read the following documentation:
- How to create a Sinatra™ Ruby Application
- How to create a Jekyll® Ruby Application
Use cPanel’s Application Manager interface (cPanel >> Home >> Software >> Application Manager) to register the application.