Silk Web Hosting: Ruby

Modified

Choosing a version

You can choose among multiple versions of Ruby:

Platform version Ruby version Command-line path Sunset Date
silkv2 3.0 (default) /opt/rubies/ruby-3.0/bin/ruby March 31, 2024
silkv3 3.1 /opt/mise/installs/ruby/3.1/bin/ruby March 31, 2025
3.2 (default) /opt/mise/installs/ruby/3.2/bin/ruby March 31, 2026
3.3 /opt/mise/installs/ruby/3.3/bin/ruby March 31, 2027

If you need to switch Ruby versions, you can do so by creating or editing your site’s .silk.ini file (for example ~/www-root/.silk.ini) and adding the version to the [ruby] section:

[ruby]
version = 3.0

Valid version choices are default, any of the versions listed in the table above, or newest (which provides the newest available on the system).

Libraries

Ruby libraries are managed using the gem command. You can see which libraries are currently installed by typing gem list. Additional modules can be installed by typing gem install --user-install <libraryname>, which will place them in your home directory, under ~/.gem/.

Web applications

Ruby web apps are written using the Rack model and use NGINX Unit as an application server. You can run an application by doing the following:

  1. Edit the .silk.ini file in your site root. Add a section similar to the following.

    :::ini
    [app]
    type = ruby
    root = myapp
    uri = /*
    document-root = public
    startup-script = config.ru
    env.RAILS_ENV = production

    The .silk.ini section name should be either “app” or any descriptive name you wish for your application that starts with “app: “. This could be useful if you wish to configure multiple apps.

    root is an optional directory under your site root containing all your application files.

    uri is a pattern matching the part of a web request URL after the hostname that should match this application, usually ending in *. For example, /* matches all pages, while /myapp* matches all pages that begin with /myapp.

    document-root is the directory under your app root in which static files will be located.

    startup-script is the name of the script launching your application, which should have executable permissions (chmod u+x config.ru).

    Any line beginning with env. will set an environment variable available within your application.

  2. If this is the first web application in your site, a new app server will be started for your account within ten minutes.

  3. Load your application with silk app <hostname> load. If you have multiple sites and/or multiple apps, <hostname> is followed by the URI path of your app, such as dev.mynetid.w3.uvm.edu/app2. If you see an error, check the app server log for details.

Reloading applications

An application needs to be restarted for code changes to take effect. You can do this the same way you originally loaded your application:

[myusername@silk21 ~]$ silk app <hostname> load

Console logs

App server logs are available at /usr/lib/unit-user-<mynetid>/unit.log.