Home > Documentation > Installation

Fresh Install

Like everything else with RATUUS, installation is very simple. Basically, there are three steps - MySQL setup, setting correct filesystem permissions and running RATUUS installer. These steps are described below in more details.


In case you are using some sort of interface to access the MySQL database this step is just few clicks for you. If not, you will need to fire up MySQL console client and issue next commands.

To create RATUUS database:

mysql> CREATE DATABASE ratuus;

To allow user ratuus to access and modify database we created in previous step, from localhost and with password 'ratuus':

mysql> GRANT ALL ON ratuus.* TO ratuus@'localhost' IDENTIFIED BY 'ratuus';
For security reasons you should use different username and password.

And to reload MySQL privilege table in order to activate user we just created:

Setting Filesystem Permissions

In order to successfully finish installation and have fully functional RATUUS running you will need to allow it write access to certain files and folders. First you will need to determine under which user your web server is running. Under Debian it is www-data, and that's what we will use in this example. For your specific distribution check the documentation.

During the installation process RATUUS will need to write MySQL database connection data into the configuration file. It will also need write access to Smarty cache and compiled templates folders.

# chown www-data: include/db_config.php
# chown www-data: sm_comp/cache/
# chown www-data: sm_comp/templates_c/

# chmod 640 include/db_config.php
# chmod 755 sm_comp/cache/
# chmod 755 sm_comp/templates_c/
If you are not sure about user used by your web server or you want to go on "insecure" side, you can just add write permissions to everybody.
# chmod 666 include/db_config.php
# chmod 777 sm_comp/cache/
# chmod 777 sm_comp/templates_c/
Ratuus Installation

Now you are ready to start Ratuus installer.

Open up your browser and go to Ratuus installation folder (http://www.your-domain.com/ratuus/install/) and you will be welcomed by this pretty screen.

After clicking "Install" button insert database connection details.

In our case that would be:

DB Host: localhost
DB User: mail_user
DB Password: some_password
DB Name: mail

Ratuus will check if the connection is possible with the data you entered and also check if the configuration file is writable by the web server (it should be if you followed all the steps in this tutorial :)). If everything is OK, it will create database tables and write connection parameters to the file.

Last step is to create superuser account. This account has permissions to perform all actions in Ratuus. It is important that you don't forget the password for this account, otherwise you will not be able to add new domains, or delete old ones.

In case you forget password for superuser account you can re-run installation. You will get opportunity to create another superuser account at the end of installation process. Ratuus installer is not destructive - it will not delete any data in your database.

And that is it. Ratuus is set-up and ready for you!