Common Issues – Self Hosted Only

Update Page Not Working

If you are running on IIS by default the extension php_openssl isn’t enabled.

You need to either add in or uncomment this line: extension=php_openssl.dll

In your php.ini file.

To find your php.ini file go to https://path-to-access-assay/info.php

And it will be listed there.

Note: you will need to restart your web service once you’ve edited the php.ini file.


Cannot Upload File

The most common reason this happens is either

  1. PHP doesn’t allow large files
  2. IIS doesn’t allow large files

You can fix the PHP by editing the php.ini file

And changing the following lines:

  • post_max_size = 256M
  • upload_max_filesize = 256M
  • memory_limit = 256M


You can fix the IIS by going to “Request Filtering” and clicking on “Edit Feature Settings” and changing “Maximum Allowed Content Length” to 300000000 (which works out at 300 MB)

More details here:


Nothing Displays or you get “Uncaught PDOException”

This is because the PDO extension isn’t enabled…


You need to remove the semicolon (;) at the front of this line


To find out where your php config file is you can go to /info.php

And look at the “Loaded Configuration File” line



$ sudo apt-get install php7.0-sqlite


$ sudo apt-get install php5-sqlite

And then restart apache


Images are not being created

Error message: “Uncaught Error: Call to undefined function imagecreatetruecolor()”

Solution… you need to enable gd

Windows: Enable in the php.ini file



$ sudo apt-get install php7.0-gd


$ sudo apt-get install php5-gd

And then restart apache

Issues on a Mac Server

You may get an error like: Fatal error: Call to undefined function imagettfbbox()

The Mac Server by default doesn’t have FreeType installed or support for PNGs…

Easiest way to do this is to install homebrew:

And then install freetype

brew tap homebrew/homebrew-php
brew tap homebrew/versions
brew install php56 --with-httpd24

Then edit the apache config file

sudo nano /etc/apache2/httpd.conf

And replace the LoadModule php5_module with this (suggest just commenting out the old line by putting a # at the front):

LoadModule php5_module /usr/local/opt/php56/libexec/apache2/

And then restart apache

sudo /usr/sbin/apachectl restart