How To Install Rails, Apache, and MySQL on Ubuntu with Passenger

How To Install Rails, Apache, and MySQL on Ubuntu with Passenger


Installing Ruby on Rails and MySQL on an apache virtual private server is the first step toward getting Ruby applications live and online. Three useful installers make the task of building this server easier than ever before.


This tutorial requires you to have a droplet or server up and running. Additionally, the rails ready script needs to be performed by a user with sudo privileges. If you don't have a user like that on your server, you can check out how to do that in steps 3 and 4 of this tutorial.

Step One—Install Rails Ready

Once you are logged in on your virtual server with your user with root privileges, type in the command to install Rails Ready:

wget --no-check-certificate https://raw.github.com/joshfng/railsready/master/railsready.sh && bash railsready.sh

Rails Ready can be installed either from the source or with RVM, the Ruby Version Manager. I would recommend using RVM—it's an easy installation and will later let you to switch between multiple versions of Ruby if needed.

Overall the installation does take a while—be prepared to wait.

However, once Rails Ready finishes the process, your VPS will be fully equipped with Ruby, Gems, and Rails. Then, following the instructions on screen, "logout and back in to access Ruby"

Step Two—Install Apache with Phusion Passenger

Once RVM is set up, you can use it to install rails:

rvm install 1.9.3

And set RVM to use Ruby 1.9.3 by default:

rvm use --default 1.9.3

Then install the passenger gem:

gem install passenger

As a useful bonus, RailsReady comes packaged with Phusion Passenger, which we can use to then automatically install and configure Apache on our server.

Use this command to start the apache installation:


Step Three—Update the Apache configuration

Passenger will display this text after Apache installs:

The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /home/username/.rvm/gems/ruby-1.9.3-p194/gems/passenger-3.0.12/ext/apache2/mod_passenger.so
   PassengerRoot /home/username/.rvm/gems/ruby-1.9.3-p194/gems/passenger-3.0.12
   PassengerRuby /home/username/.rvm/wrappers/ruby-1.9.3-p194/ruby

To finish the process, open up the Apache config and paste the three required lines into the file:

 sudo nano /etc/apache2/apache2.conf

Save and Exit.

Step Four—Install MySQL

Before we conclude the installation, we should add one more useful program to our virtual server.

MySQL is a powerful database management system used for organizing and retrieving data.

To install MySQL, open terminal and type in these commands:

sudo aptitude update
sudo aptitude install mysql-server

During the installation, MySQL will ask you to set a root password. If you miss the chance to set the password while the program is installing, it is very easy to set the password later from within the MySQL shell with this command:

UPDATE mysql.user SET Password = PASSWORD('password') WHERE User = 'root';

Congratulations! WIth the help of three useful installers, we now have Ruby on Rails, Apache, and MySQL on our Ubuntu server!

See More

Once you have installed Ruby on Rails on your server, you can proceed to Create a SSL Certificate for your site or Install an FTP server

By Etel Sverdlov

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about us

About the authors

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

This comment has been deleted

    Kamal Nasser
    DigitalOcean Employee
    DigitalOcean Employee badge
    September 1, 2013

    @er.tejaspatel88: Did you follow Step 3? You should restart apache after editing the config files:

    <pre>sudo service apache2 restart</pre>

    My virtual Host file looks like

    <VirtualHost *:80> DocumentRoot /var/www/testapp.varniinfotech.com/public ServerName testapp.varniinfotech.com ServerAlias www.testapp.varniinfotech.com <Directory /var/www/testapp.varniinfotech.com/public> AllowOverride all Options -MultiViews </Directory> </VirtualHost>

    I set up Apache and Passenger but my rails app display directory structure rather than rendering actual rails app.Can anyone please shed some light how it works?

    Could you change rvm install 1.9.3 to rvm use --install ruby - it is essential to use ruby as it configures environment and of course using latest ruby is encouraged as it’s compatible with older versions (checked with rails)

    A few things re this tutorial:

    Instead of dumping the following into the apache.conf

    LoadModule passenger_module /some/path/here/mod_passenger.so PassengerRoot /some/path/here/passenger-3.0.12 PassengerRuby /some/path/here/

    It’s considered to be best practise to instead create two files: /etc/apache2/mods-available/passenger.load and /etc/apache2/mods-available/passenger.conf

    passenger.load #obviously swap this path out with correct path as per the passenger installer LoadModule passenger_module /some/path/here/mod_passenger.so

    passenger.conf #obviously swap these paths out with correct paths as per the passenger installer PassengerRoot /some/path/here/passenger-3.0.12 PassengerRuby /some/path/here/

    Then run

    sudo a2enmod passenger

    The same process can be applied when creating your vhosts; instead of creating the vhost inside apache2.conf /etc/apache2/sites-available/somesitehere.com

    sudo a2ensite somesitehere.com

    Additionally, rbenv is considered by many to be superior to rvm. Quick install of rbenv would go as follows on Ubuntu.

    curl -L https://raw.github.com/fesplugas/rbenv-installer/master/bin/rbenv-installer | bash #copy the script output into the top of ~/.bashrc rbenv bootstrap-ubuntu-12-04 rbenv install 1.9.3-p385 rbenv global 1.9.3-p385 ruby -v gem install bundler --no-ri --no-rdoc rbenv rehash bundle -v

    I get the following error when I try to restart apache:

    apache2: Syntax error on line 265 of /etc/apache2/apache2.conf: Cannot load /home//.rvm/gems/ruby-1.9.3-p194/gems/passenger-3.0.12/ext/apache2/mod_passenger.so into server: /home//.rvm/gems/ruby-1.9.3-p194/gems/passenger-3.0.12/ext/apache2/mod_passenger.so: cannot open shared object file: No such file or directory Action ‘configtest’ failed. The Apache error log may have more information. …fail!

    Might I suggest adding a section of the Apache virtual directory set up

    It looks like you need to install Ruby and Passenger prior to installing the Apache 2 module. I have emailed DO about this, and they are going to update this article.

    Thanks, everyone!

    Thanks, Andrew. I should have noted that I’ve tried it without sudo with the same result. Am I supposed to use passenger-install-apache2-module in conjunction with an rvm command somehow?

    Try DigitalOcean for free

    Click below to sign up and get $200 of credit to try our products over 60 days!

    Sign up

    Join the Tech Talk
    Success! Thank you! Please check your email for further details.

    Please complete your information!

    Featured on Community

    Get our biweekly newsletter

    Sign up for Infrastructure as a Newsletter.

    Hollie's Hub for Good

    Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

    Become a contributor

    Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

    Welcome to the developer cloud

    DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

    Learn more
    DigitalOcean Cloud Control Panel