How to Create Ruby Web Applications

Last modified: August 12, 2021



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.


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

If your system runs CentOS 6, change ruby27 to ruby24 in the following instructions.

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

  1. 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).

    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.

  1. Create a Ruby web application on your server. For examples of web applications that you can create, read the following documentation:

  2. Use cPanel’s Application Manager interface (cPanel >> Home >> Software >> Application Manager) to register the application.

Additional Documentation