Installation Issues

This tutorial shows you how to handle issues with your ZOO component during the installation. Most of the time installation problems are due to limited resources, e.g. on shared hosting servers. Limited resources can be the PHP maximum upload/post size, the PHP maximum execution time or the overall memory limit.

To solve these problems you can either allocate more resources for PHP by modifying the file directly. Sometimes this is not possible in this case you can try to set these PHP settings through a .htaccess file on your webserver. Even though this also depends on your hosting server if it allows the usage of .htaccess overrides. Here an overview of the PHP configuration settings you should check and increase if needed:

  • post_max_size
  • upload_max_filesize
  • max_execution_time
  • memory_limit


To change the PHP configuration through the php.ini file use the following syntax.

# example of recommended settings
post_max_size = 8M
upload_max_filesize = 8M
max_execution_time = 60
memory_limit = 128M


To change the PHP configuration through a .htaccess file use the following syntax.

# example of recommended settings
php_value post_max_size 8M
php_value upload_max_filesize 8M
php_value max_execution_time 60
php_value memory_limit 128M

Installation from Directory

As an alternative you can always use the Install from directory method explained in our Install ZOO tutorial. This installation generally uses less resources rather than installing from a .zip file, and it resolves these common issues:

  • PHP maximum upload/post size limits
  • Problems with PHP execution timeouts
  • Issues when unpacking the .zip file

The Joomla error messages during installation are sometimes misleading. e.g. Joomla claims that it is unable to find the installation package, when it actually wasn't uploaded completely due to the PHP Maximum Upload Size limit.

ZOO Documentation