FileRun installation guide

  1. Download FileRun and “unzip.php”.
  2. Upload the two files to your server, both in the same folder.
  3. Run unzip.php in your browser. Depending on when you uploaded it, its URL should be something like this “http://www.your-site.com/the-folder/unzip.php

The script file unzip.php only unzips the FileRun archive and redirects to “/” (index.php). If it fails on your particular PHP setup, you can simply manually unzip the FileRun archive and upload the extracted contents to your web server's folder and access that in your browser.

After doing the above you should now be looking at the FileRun installation wizard. Follow the installation wizard to check your server configuration and complete the MySQL database setup.

You will be asked to type in the credentials that FileRun will use for connecting to the MySQL server and database. We recommend you to avoid connecting FileRun using the MySQL root account. From a security perspective, it is much better to create a separate user account.

  • The superuser is the only account not protected against brute force login attacks, so it is very important that you set a password that cannot be guessed by a computer. Set a long password, containing also uppercase letters, digits and symbols.
  • By default, the superuser's home folder is located inside system/data/ folder. It is important that you edit the user's settings and set the home folder path pointing to a folder which is located outside the public area of your web server (ie. outside www).
  • Accessing the FileRun installation via SSL/HTTPS, instead of plain HTTP will strongly increases your data security. Get a free SSL certificate for your server here: https://letsencrypt.org
  • Make sure session.cookie_httponly is set to On, in your server's PHP configuration file, for increased security against cross-site-scripting attacks.
  • Update the configured MySQL user account and remove the “ALTER” and “DROP” privileges. You might need to add these back before installing any FileRun update.
  • If you are on a shared hosting service, make sure the permissions of the FileRun application files do not allow PHP (or any other web server application) to make changes to them. Make an exception for the “system/data” folder, where FileRun needs to be able to make changes.

Blank page

The blank pages are usually hiding PHP errors. If you set display_errors = On in your PHP configuration file, the possible errors will be displayed. Alternatively you can check the PHP error log for the error information.

MySQL error: Invalid default value for 'date'

The solution is to locate your MySQL configuration file “my.ini/my.cnf”, look for the following line (the value might be different):

sql-mode = "STRICT_TRANS_TABLES,NO_ZERO_DATE"

and change it to:

sql-mode = ""

and finally restart the MySQL server.

Feel free to get contact us with anything, we are here to make sure you will be able to install and run FileRun successfully.