How to configure a live server for TYPOlight

This chapter is not about configuring a server in terms of installing Apache or compiling PHP, which you cannot do on a shared hosting account anyway. It explains how to check whether the TYPOlight system requirements are met and how to enable PHP 5.

TYPOlight system requirements ¶

TYPOlight requires a webserver like Apache or IIS with PHP and MySQL support. The minimum PHP version is 5.2 and the minimum MySQL version is 4.1, however we recommend using MySQL 5 for a better performance. You also need the PHP extensions GDlib (image resizing) and SOAP (Extension Repository) and optionally mbstring (multi-byte character handling) and mcrypt (data encryption). TYPOlight has been tested successfully with all major browsers like Firefox (from version 2) or Internet Explorer (from version 7).

Enabling PHP 5 ¶

Fortunately, most providers meanwhile offer PHP 5, so you just have to find out how to enable it - unless it is the default PHP version of course. If you are lucky, your server administration panel supports switching the PHP version, in which case you can skip to the next paragraph. If not, it most likely takes some .htaccess magic to enable PHP 5. Navigate to the TYPOlight directory and rename the ._htaccess file to .htaccess. Then open it in a text editor and try one of the lines below or ask your provider which line to use.

AddHandler x-httpd-php5 .php
AddHandler php5-cgi .php
AddHandler php-cgi2 .php
AddHandler php-fastcgi5 .php
AddType x-mapp-php5 .php
AddType application/x-httpd-php5 .php
Action php /cgi-php5/php

Using the TYPOlight system check tool ¶

Download the system check tool below to find out whether your server is ready for TYPOlight and wether you need to enable the Safe Mode Hack or not. Simply upload the file to the TYPOlight root folder, open it in a web browser and follow the instructions.

ISP-specific settings ¶

There are a few major Internet Service Providers that require a little extra configuration to get TYPOlight to work. Fortunately, they are just the exception from the rule. If you are looking for hassle-free TYPOlight hosting, check out the list of TYPOlight hosting partners.

Additional information about ISP-specific settings is available in the TYPOlight forum.