Installing Ruby

Ruby is a popular object-oriented programming language that you can install and enable to work with a cPanel system. Learn more about the Ruby programming language by visiting the Ruby website.

Requirements

• cPanel & WHM version 11.
  • To check your cPanel version, log into WHM. cPanel's version number can be found in the upper right-hand corner of the screen.
• root access to the server on which you wish to install Ruby.
• A working yum configuration.
  • To test whether or not you have a working yum configuration, log into your server as the root user and issue the following command via the command line: yum list ruby
  • If you are returned to the command line without any errors after running this command, your yum configuration should work. The output of this command may resemble the block below.

root@server [~]# yum list ruby
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

• If you intend to install Ruby on a FreeBSD system, you will need to ensure that your ports and packages systems are working. To learn more about these systems, you can visit FreeBSD's documentation here.

Installing Ruby

To begin, you will need root access to the server on which you wish to install Ruby. To continue:

• Execute the following script to install Ruby: /scripts/installruby

After installing Ruby, you will need to make sure that the appropriate ports are opened for your cPanel users. By default, Ruby applications begin on port 12001. Ruby application port numbers are automatically incremented with each new Ruby application. This means that the first Ruby on Rails application created on your server will use port 12001, while the second Ruby on Rails application will use port 12002.

Troubleshooting

Since Ruby on Rails uses its own web server, it has to run this web server on an alternate port. This causes an issue if you are running a firewall on your system. You will need to ensure that ports 12001 and up are open. We recommend making the max number of the open ports 12001 plus whatever the number of Ruby applications you expect to be running will be.

From time to time the RubyGems repository will be unavailable. If at any point during installation process the RubyGems repository becomes unavailable, you will need to re-run /scripts/installruby.

For more information, you can visit Ruby's documentation here.