Manual FileRun Installation

Installing FileRun on a web server doesn't really require any technical knowledge. There is no config file to be edited and absolutely no command line action. You basically just upload the downloaded application files to your server.

This guide is for installing with an existing HTTP server that already meets the requirements

Here is an NGNIX PHP example configuration.

Let's assume for this guide that your website is mywebsite.com and you want to have FileRun running at http://www.mywebsite.com/my-files.

Download the installation zip archive from the FileRun client area: https://filerun.com/client-area/client-area-orders

The download is available only for holders of an Enterprise license with valid support service.

1. Create the folder my-files on your web server.
2. Upload the FileRun zip to your server inside the my-files folder. Rename to FileRun.zip.
3. Download this script file unzip.php (right-click and choose “Save link as..”) and also upload it to your my-files folder, next to FileRun.zip.
4. Open your browser and go to https://www.mywebsite.com/my-files/unzip.php

This is the preferred method because it's faster and also ensures that FileRun/PHP has write access to the application folders.

Unzip the FileRun files yourself and upload them to your server via FTP (or any other method you prefer).

You will most probably need to change the permissions of the folder system/data so that FileRun can write temporary data inside that folder.

On a Linux server, this would be done with a command like:

sudo chown -R www-data:www-data system/data  

If SElinux is installed and enabled, we need to change the context for Apache to be able to make changes inside that folder:

chcon -t httpd_sys_rw_content_t -R system/data 

You should now be presented with the FileRun installation wizard. If not, go to the troubleshooting section.

The web-based installer will make sure your server configuration is suitable for FileRun and will help you setup the FileRun database. FileRun needs a MySQL database for storing various data and settings. (Note that FileRun never stores files inside the database. Files are always stored in regular folders on the server's drive.)

You will be asked to type in the username and password of the MySQL user account FileRun will use to access its 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 MySQL user account.

The superuser's account will be created without a home folder.
You will need to edit the user account and set a home folder before being able to upload files.

You can either set the path of an existing folder from your server, as the user's home folder, or create a new empty folder to store your uploaded files in. Either option you choose, it is important that the selected folder is located outside the public area of your web server (ie. outside www), otherwise the files will be accessible directly by their own URL, bypassing FileRun' security.

For a good user experience, we strongly recommend you to enable ImageMagick.

Don't forget to secure your installation.