How to Create Ruby Web Applications

Last modified: January 26, 2024



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

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). For more information about the Ruby set up requirements for Ubuntu®, read our Using Passenger Applications documentation.


    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.

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

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

Additional Documentation