I assume that you downloaded TomatoCMS and unzipped it into a folder named tomatocms in your web root directory. In localhost, the full path of folder is <Your_Apache_Installed_Directory>/tomatocms.

Now, go to http://yourdomain.com/tomatocms/install.php

Step 1: Checks the requirements

At the first step, Install Wizard will check the requirements of your server. TomatoCMS requires PHP 5.2.0 or newer and following PHP extensions:

gd, json, mbstring, mysql, pdo, pdo_mysql, simplexml, xml, xmlreader.

In addition, a few files/directories have to be writable.

If your server does not meet two conditions above, the Next button won't be visible.

Otherwise, click on Next button to go to next step.

Step 2: Configures your site

IMPORTANT NOTE: You have to create the database before performing this step.

I assume that you created database named tomato_cms and granted all permissions to the user which have user name of tomato and identify by password 123456.

(1): The host name or IP of your MySQL server

(2): The port which your web server use to connect to database server.

You should leave two settings as default.

(3), (4): The user name and password to access the database.

(5): Database name. As I said above, this database have to be created firstly.

Now, jumps to next section which will ask you for your website information.

(1): The URL of your website. If you puts TomatoCMS in web root directory, the URL will be http://localhost or http://YourDomain

Leave it as default.

(2): Name of your site

(3): Select language for your site. TomatoCMS support multilingual site, but there are two languages which was built in, there are English and Vietnamese.

(4): Select template for your site. TomatoCMS support template/skin architecture, it means you can upload and install other template later.

By default, TomatoCMS built two templates which are for news site and bloggers.

(5): Select the skin. At this version, there is only one skin for each template.

(6): Enter the keyword of your site. If you want to many keywords, lets separate them by a comma. This will be taken for meta keyword tag of your site.

(7): Enter description about your site. Like keywords setting, value of this field will be taken for meta description tag.

The final settings are related to date time.

(1): Select your timezone.

(2), (3): Enter your date and date time formats. You can find all PHP date time settings here.

Press the Next button to go to next step.

Step 3: Completes the installing

Final step is coming.

YOU HAVE TO PRESS THE CONFIRM BUTTON AT THIS STEP to complete installing TomatoCMS.

After pressing this button, you can go to the administration section via address: http://Your URL/admin/

The default username and password are admin (Don't forget to change this password).

Step 4: Import our sample data

Although this step is not required, but we recommend you to perform this step to avoid most popular issues when you manage your site in backend section.

The sample data, is collection of SQL queries, which can be imported from your MySQL client tool like phpMyAdmin. This file is tomatocms_sample_db.sql located in install folder.

POPULAR ISSUES:

I installed the TomatoCMS successfully, but when logged in to backend and try to access some other admin sections via top menu, I always received the error which showed that some resource was not found like

Resource 'core:cache' not found

What should I do?

Install Wizard, in fact, will install the database schema and minimum data which ensure your website run correctly. If you want to run other functions in backend, due to permission system, you have to create resource first.

In backend section, go to User >> Privilege menu.

Clicks on Add links to create resource and [+] buttons to create actions associated with resource.

Repeats this untill all resources and actions created.

This error does not occur if you imported sample data (described in step 4 above).

It's inconvenient so we will fix this in next version.

If you have trouble with installing TomatoCMS, leave your errors in the comment or drop an email on core@tomatocms.com

Thanks you so much.