Development

Context Navigation

Installation
1. System requirements
2. Note on live update
Download a TYPOlight package
1. Unpack the TYPOlight archive
2. Set up a new database
Start the install tool
Related links

Installation

TYPOlight webCMS is a web application based on the programming language PHP5 and a database like MySQL. Therefore you need to have access to a web server which supports PHP5 and MySQL version 4.1 or newer. If you want to install TYPOlight on your local computer you can use the open source application XAMPP (see http://www.apachefriends.org).

System requirements

PHP5 > 5.1.0
PHP mbstring enabled
PHP GDlib enabled
MySQL > 4.1

You can find a detailed list of system requirements on the project website.

Note on live update

TYPOlight requires writing permission to modify files and folders! If you run PHP as module you might have to change the file mode (CHMOD) before you start updating. In addition please:

back up your database and all files
then run the live update
restore your backup if there have been errors

Download a TYPOlight package

On the TYPOlight project website you will find a download link to the open source portal sourceforge.net where you can download the latest TYPOlight package as a ZIP (Windows) or TAR archive (Unix). On a Unix server you can also use the following command:

wget http://prdownloads.sourceforge.net/typolight/TYPOlight_webCMS_2.2.tar.gz?download

Unpack the TYPOlight archive

Unpack the TYPOlight archive in a directory on your server or use an FTP client to upload the files to your server.

Set up a new database

Now, set up a new database for your TYPOlight installation. The install tool itself is not able to create new databases since this feature is disabled on most shared hosting accounts anyway. TYPOlight uses the table prefix tl_, therefore it is possible to run TYPOlight parallel to other applications in the same database (not recommended).

Start the install tool

From this point the TYPOlight install tool will guide you through the rest of the setup process. Open the following URL in your web browser:

http://www.your-domain.com/typolight/install.php

If you have installed TYPOlight in a subdirectory or if you have unpacked it directly on your server, the URL might look like this:

http://www.ihre-domain.de/TYPOlight_webCMS_2.2/typolight/install.php

Next, please enter the install tool password. The default password is typolight. For security reasons the install tool will be blocked if you enter a wrong password more than three times in a row.

Change the install tool password

First, you will be prompted to change the install password. Enter a new password which consists of at least 8 characters (letters, numbers and special characters). Then click the "change password" button. The install tool will check whether all required PHP extensions are installed and points out missing extensions, if any.

Create an encryption key

TYPOlight requires an encryption key in order to encrypt data. Once there is encrypted data it can only be decrypted with this key! Leave the field blank to make TYPOlight generate a random key automatically. If your database already contains encrypted data you can enter your encryption key here.

Connect to database

Next, set up the database connection. Choose a database driver and enter the login details of your database. The host name is usually localhost. Some default MySQL parameters are already set.

Update tables

Once there is a database connection, TYPOlight will check whether all required tables and columns exist. If changes are necessary, TYPOlight will show a list of queries which you can confirm or disable. Thus, you can control which modifications will be made when you click the "update database" button.

Import the example website

Afterwards, you can choose whether to import the "Music Academy" example website. Please note that any existing data will be deleted! If you choose to import the example website you will be able to log in as k.jones (password kevinjones). Otherwise, the install tool will prompt you to set up an administrator account.

If you import the example website any existing data will be deleted!