Installing Rails

Ruby on Rails is a popular web application framework built with Ruby. Opalstack provides a simple installer for Rails with Ruby 2.6 served by Puma.



Create a shell user if you have not done so already. You can use an existing shell user if you wish.


Click on Applications in the control panel sidebar.


Click the button labeled "+ Add Application" in the upper-left corner of the content area.


Select Ruby on Rails as the application type.


Enter a name for your application in the Name field.

This name will be used to create a subdirectory in your shell user's apps directory such as /home/username/apps/appname.


Select the shell user that will host the application.

If you have multiple servers, be sure to select the shell user that is located on the server from which you intend to serve your site.


Click the "Add Application" button to save your new application.


A notification will appear in the control panel when the application is ready. This may take a minute or longer.

When the installation is complete, the following files and directories will be present in the application directory:

  • start and stop scripts to control the operation of your application.
  • env: a directory containing the Inital Rails gems used by your application.
  • tmp: a directory containing temporary files used by your application
  • myproject: a directory containing a demo Rails project.
  • README: basic info regarding the new application.

Post-installation Steps

Please take the following steps before you begin to use your Rails installation:


Connect your Rails application to a site route in the control panel.


Edit /home/myuser/apps/myapp/myproject/config/environments/development.rb to set config.hosts to include your site's domains. Example:

config.hosts << ""
config.hosts << ""

Run the following commands to restart your Rails instance: