This is an old tutorial. Please check our wiki at for updated documentation.

Installing RubyStack

In this article we are going to cover the whole installation of our RubyStack. We are going through all the installation steps explaining all the pages of the installer. We hope it helps and encourages people to start The first step is downloading the installer from the RubyStack page and running it by double clicking over it.


If you click "Next", a list of the components to be installed will be shown. As you can see, a lot of useful tools and gems will be installed.


On the next page, you will have to choose whether to install the RubyStack files. Notice that you can't install RubyStack over a previous version. In that case, you'll have to choose another location. If you want further directions about how to upgrade RubyStack see the tutorial From InstantRails to RubyStack.


By default, MySQL server will listen at port 3306, if that port is already occupied or cannot be taken for any reason you will be asked for another one. Just choose whatever you want, like 3307 or 3308 and click "Next". If the port can be taken this page will not appear.


Now you have to choose the password for the root user of MySQL. This password will only be needed when creating a new Rails application. Do not worry about remembering all this information because everything will be stored in the "Installation Report", accessible through its "Start Menu" entry.


RubyStack creates and configures an empty web application for you inside the directory "projects". Now you'll be asked for a name for that web application. This name will just be the name of the directory whether your application will be stored and the user name your application will use when connecting with the MySQL server.


Now choose a password for your non-root MySQL user. RubyStack creates a MySQL user with the same name of you application that will be used by your application when connecting to the database server. Choose a password for it.


Now the installation is ready to begin. You can lick "Next" and go for a cup of coffee :).


After clicking "Finish", a text file with very port numbers, paths and passwords will be shown. Just notice that this file is stored in the root directory of your RubyStack installation and can also be accessed through its "Start Menu" entry. Keep it in a safe place.


Finally, the web server of your brand new web application will be launched inside a command line window and your default browser will point to its corresponding URL.


You are ready to go! Just open an "Use Ruby" window (accessible through the "Use Ruby" "Start Menu" entry) and start programming. If you want to learn more about how to start programming with Ruby on Rails, we recommend you the tutorial Rolling on Rails with RubyStack.

Thanks for reading and do not hesitate visiting our Bitnami Forums to express your ideas or report any kind of problem you find.