Installation – Ubuntu 7.04 Feisty Fawn

1. Start with a clean slate Linux installation. Make sure that you don’t have anything Ruby-related installed on it.

Do not call your admin account rails. RubyWorks uses that as a service account name, so you will be effectively giving root privileges to your web servers. That’s bad for security.

2. Import RubyWorks repository public key:

wget http://rubyworks.rubyforge.org/RubyWorks.GPG.key
sudo apt-key add RubyWorks.GPG.key

Note: RubyWorks DEBs are signed, this step tells your package manager to trust the signature. MD5 checksum of the key file should be 971cf342ec253b0f5288cf55cbcf5e12.

3. Point your package manager to RubyWorks APT repository. Open file /etc/apt/sources.list in a text editor, and add this line to it:

# For 32-bit architecture
deb http://rubyworks.rubyforge.org/debian/DEBS/i386 /
# For 64-bit architecture
deb http://rubyworks.rubyforge.org/debian/DEBS/amd64 /

4. Workaround a bug of runit:

sudo touch /etc/inittab

5. Install RubyWorks

sudo aptitude update
sudo aptitude install rubyworks

If all goes well, you now have a skeleton Rails application up and running at http://localhost:3001. There is also monitoring console running at http://localhost:2812. Congratulations!

Note that the monitoring console at this point will only be accessible from localhost. The next page tells you how to make it available on the network.

If something goes wrong, seek help at rubyworks-users mailing list.

Theoretically, at this stage you can leave everything as it is, and it will work. However, especially if you are installing RubyWorks for the first time, you should go to the next page and work through the instructions there. You will set some passwords, learn what is where, and how to customize RubyWorks configuration to suite your taste.