Installation Issues

This tutorial shows you how to handle issues with your Warp theme during the installation. Most of the times 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 php.ini 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's 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

As an alternative you can always use the manual installation explained in our Joomla or WordPress tutorial. This install 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.

Documentation on Github

Help us out! If you are feeling that our documentation has errors or can be improved, fork it at Github and send us a pull request. Any contribution is much appreciated. Thank you!