Already running Theia? Just want to upgrade and keep all your data? Go here!

Installing Theia basically consists of 3 parts:

1) configuring the core configuration file (core.cfg.php) 2) uploading all of Theia's files to your web server 3) running the installation wizard, which sets everything up for you

Configuring Theia's core.cfg.php file

If you haven't modified Theia's cfg.php file (in the main source directory) then the location of Theia's configuration will be:

cfg/core.cfg.php

You will need to open this file on your computer, using your favorite text editor. Notepad, Wordpad and Gedit are text editors; Microsoft Word is *not* a text editor. This is how a default core.cfg.php file will look:

While it may look overwhelming at first, don't fret, because most of this file doesn't need to be modified unless you are want to restructure Theia's directory tree.

MYSQL_HOST should be set to the address of your mySQL server. Sometimes this can be a domain name, or an IP address, but more often than not, it should be set as "localhost".

MYSQL_USER should be the mySQL user name that is used to connect to the database.

MYSQL_PASS should be the password that the mySQL user uses to verify their access to the database.

MYSQL_DBNM should be set to your database's name. Please note that Theia does NOT create the database itself, but only the tables within the database.

Additionally, you may want to use a special "table prefix", which is where TBLPRE comes in. By default this is set to theia_, which means all of Theia's mySQL tables within the database will contain "theia_" before the table name. This is useful for grouping all of Theia's tables together, because you may have other tables in the same database. If you are unsure what to do here, just leave TBLPRE as it is.

Notice: The BASE constant has been removed from 1.0.0b5 and up, as this value is now determined dynamically! Ignore any reference to BASE in the screen shot shown.

And finally, there is one more constant that should be set: BASE_URL. BASE_URL should be the absolute URL to the base of your site (again, without a trailing slash), so this should look something like http://www.mysite.com.

Everything else in this file can be left alone, and is only provided for users who wish to change Theia's directory names or locations.

Uploading Theia's files

If you've ever done anything with your own website, then this step should be fairly fool proof. Uploading Theia's files to your web server is done no differently than uploading any file to your web server. Just use an FTP client (such as FileZilla), and upload all of Theia's files to the path you have specified in Theia's configuration file.

Notice: some folks get confused and might think to upload the src directory itself (which contains all of Theia's files), but what you want to do instead is simply select all the files and directories *within* src and upload all of these; in other words, don't upload the src directory itself, but merely its contents. Like this:

Running Theia's installation wizard

It is called a "wizard", because it tries to do a lot of the guess work, and complicated processes by itself.

To run the wizard, enter the URL of your site in your web browser. Any URL for one of Theia's scripts should automatically redirect you to the installation wizard, but you can also go to the wizard directly, by going to something like this:

http://www.mysite.com/wizard.php

You should see something that looks like this:

There are two methods of installation here, and if this is your first time installing or using Theia, then you are strongly urged to use the "advanced" routine. As the wizard states, "advanced" does not refer to the level of knowledge necessary, but refers to the amount of work that the wizard installation performs. Choosing the "express" routine will not perform numerous tasks which a newcomer to Theia will want taken care of for them.

As long as you read what each step's information and what each previous steps' results say, you should be able to get through the wizard without any trouble as it explains everything that is going on.

Running into problems?

Are you having trouble getting Theia setup properly? If you are, join in our support forum. Or, you're welcome to contact SikoSoft with the error you are getting.

If you would like to purchase a professional installation, we do offer this service at $75 (with a free additional upgrade installation, redeemable within 6 months of your installation). Currently, we only accept paypal, but will support additional payment methods shortly! If you would like to purchase an installation, contact us!