Legacy Ruby Installation Requirements


Last modified: May 2, 2023

Overview

Warning:

We deprecated the legacy Ruby codebase in cPanel & WHM version 66. 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).

To install Ruby and create Ruby web applications in cPanel & WHM version 66 and later, follow the directions in our How to Create Ruby Web Applications documentation.

Before you install Ruby in cPanel & WHM version 64 and earlier, make certain that you meet the following installation requirements:

Operating system

Your server must run CentOS 7, Red Hat® Enterprise Linux® (RHEL), or CloudLinux™ 6 or 7.

Note:

We do not currently support Ruby on Rails® installations on CentOS 7, AlmaLinux OS, Rocky Linux™, CloudLinux 7 or 8, or RHEL 7 servers.

Permissions

You must possess root-level access on the server.

YUM

Your server’s installation of yum must function properly.

Test your configuration

To test your YUM configuration, log in to your server via SSH as the root user and run the following command:

yum list ruby

If you do not see any errors after you run this command, your YUM configuration functions properly.

The output of this command should resemble the following example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
Setting up repositories
update                    100% |=========================|  951 B    00:00
base                      100% |=========================| 1.1 kB    00:00
addons                    100% |=========================|  951 B    00:00
extras                    100% |=========================|  951 B    00:00
Reading repository metadata in from local files
primary.xml.gz            100% |=========================|  83 kB    00:00
sqlite cache needs updating, reading in metadata
update    : ################################################## 287/287
Excluding Packages in global exclude list
Finished

Additional Documentation