FileRun installation guide
- Need hosting? Get $10 credit with DigitalOcean, a hosting service we recommend for FileRun.
- Installing on DigitalOcean or CentOS? Use this tutorial
- Familiar with Docker? Use this Docker image
- Using Cloudron? FileRun should be able for installation with just a click.
- Using a cPanel hosting? Follow “this guide” instead.
- Before proceeding, make sure your server meets the requirements: http://www.filerun.com/requirements
1. Upload FileRun to your server
- Upload the two files to your server, both in the same folder.
unzip.phpin your browser. Depending on when you uploaded it, its URL should be something like this “
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.
2. Complete the web based installation
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.
3. Securing the installation
- 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
- 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_httponlyis 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.
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.
Still having troubles
Feel free to get contact us with anything, we are here to make sure you will be able to install and run FileRun successfully.