Advanced configuration

Most of the configuration is done from FileRun's control panel. However, there are additional configuration options that can be set by editing the file “customizables/config.php”. If the files does not exist, you can simply create it. Note: The PHP file needs to start with <?php on the first line.

User Interface

$config['app']['ui']['custom_css_url'] = 'custom.css';Loads an additional CSS file with your customizations. It's better to do this than edit FileRun's existing CSS code.
$config['app']['ui']['custom_js_url'] = 'http://your-website/your.js';Add custom JavaScript code to the FileRun UI
$config['app']['ui']['enable_favicon_ico'] = true;Allows browsers to use the file “favicon.ico” for the bookmark icon.
$config['app']['ui']['ReadMeFileName'] = "README";Sets the name of the file that is used for displaying folder information.
$config['app']['hidden_file_names'][] = "*.exe";Hides all files who's names are ending with “.exe”. You can add multiple configuration lines like this one, to hide additional files.
$config['app']['hidden_folder_names'][] = "_*";Hides all folders who's names are starting with “_”. You can add multiple configuration lines like this one, to hide additional folders.
$config['app']['upload']['max_simultaneous'] = 5;Change the number of files FileRun is simultaneously uploading. The default number is 3. As a rule of thumb, the larger your files, the smaller this number, and vice-versa.
$config['app']['labels']['default'] = [['color' => 'green', 'text' => 'APPROVED'], ['color' => 'orange', 'text' => 'PENDING'], ['color' => 'red', 'text' => 'REJECTED']];These are the default labels, which can be customized as desired.
$config['imagemagick']['older_than_6_3_2'] = true;Use when the version of ImageMagick ont he server is older than 6.3.2, or if the file previews are not centered inside the thumbnails, but aligned on the left side.
$config['app']['thumbs']['output_small_filesize'] = 8388608;By default, images smaller than 8MB are send directly to the browser instead of having a thumbnail generated. You can alter this limit.
$config['imagemagick']['fileSizeLimit'] = 1048576;Limits the ImageMagick thumbnail generation only for files larger than 1048576 bytes (1MB).
$config['app']['disable_sound_notification'] = true;Sets the default state of the sound notifications to off.
$config['app']['media']['music']['latest']['limit'] = 100; $config['app']['media']['music']['random']['limit'] = 100; $config['app']['media']['photos']['latest']['limit'] = 100; $config['app']['media']['photos']['tags']['limit'] = 100;Customize various media folder listing limits.
$config['app']['metadata']['search']['results']['limit'] = 200;Customize the number of files listed in the search-by-metadata result
$config['app']['metadata']['search']['results']['limit'] = 200;Customize the number of files listed in the search-by-metadata result
$config['app']['ui']['login_logos']['acme'] = '';Access the FileRun installation URL by appending “?client=acme” to show that particular pre-configured logo instead of the default configured one.
$now = new DateTime();$nextWeek = $now->add(new DateInterval('P1W')); $config['app']['weblinks']['defaults']['expiry'] = $nextWeek->format('Y-m-d');Make weblinks expire by default after one week. For other time intervals, see
$config['app']['email']['dont_send_pass'] = true;Do not include the configured weblink passwords in the e-mailed links. Use this if you wish to provide the password in a separate message or using an alternative communication method.
$config['app']['weblinks']['forcePasswords'] = true;Forces the users to set passwords to the created web links.
$config['app']['email']['bcc_files'] = "";Send a BCC copy of all “Send by e-mail” messages to “”.
$config['app']['weblinks']['comments']['show'] = true;Display the comments users attached to files.
$config['app']['weblinks']['comments']['hide_names'] = true;* Depends on the above. Hides the users names, so only their comments are displayed.
$config['app']['weblinks']['comments']['hide_dates'] = true;* Depends on $config['app']['weblinks']['comments']['show']. Hides the dates of the users comments.
$config['app']['weblinks']['disableShortURL'] = true;Disables the option of generating short links.
$config['app']['weblinks']['force_download'] = array("html", "txt", "pdf");Makes PDF, HTML and TXT files download when accessing a Web Link, instead of being opened inside the browser.
$config['app']['weblinks']['show_page_before_download'] = true;Accessing a Web Link that points to a file will display the page “system/modules/weblinks/sections/default/html/pages/download.html” before the file is being downloaded, regardless if the weblink has comments enabled or terms attached.
$config['app']['weblinks']['audio_file_types'] = array("mp3", "ogg", "flac", "wav", "mpg");Defines the list of types of files that should be included when opening a Web Linked folders as audio playlist. The above is the default list of file types.
$config['app']['weblinks']['logging']['downloads']['disable'] = true;Disables logging of downloads through Web Links.
$config['app']['weblinks']['logging']['folder_access']['disable'] = true;Disables logging of accesses made to Web Linked folders.
$config['app']['weblinks']['logging']['referrer']['disable'] = true;Disables logging of visitors' referrers on downloading Web Links.
$config['app']['email']['enableWebLinkThreshold'] = 20971520;Send files by e-mail as Web Links if their sizes are higher than 20MB. The default value is 10485760 (10MB).
$config['app']['weblinks']['useClientEmail'] = true;Force users to send files using their local e-mail programs instead of FileRun's own function.
$config['app']['weblinks']['custom_url_shortener'] = '';Configure custom URL shortener. The example is based on Yourls ( For shorteners which require the FileRun weblink address to be present in the URL, use the ### placeholder.
$config['app']['email']['sendFromDefault'] = true;Have the files send by the users via e-mail be sent from the configured default e-mail address instead of the e-mail address of the sending user.
$config['app']['weblinks']['allow_html'] = true;Allow linked HTML files to be displayed in the browser. Can allow malicious users to run XSS exploits and attack other FileRun users. Use responsibly.

Admin and security

$config['app']['signup']['unique_company'] = true;Force users to type a unique company name at registration.
$config['app']['admin']['users']['delete']['skipHomeFolderSubCheck'] = true;Allows you to delete one user's home folder when you are deleting the user accounts, even if the user's home folder contains other users' home folders. We recommend you not to use this option, to avoid accidental file loss.
$config['app']['login']['2step']['allow_user_control'] = false;Prevents users from enabling or disabling the 2-step verification for their accounts.
$config['app']['login']['restrict_ip']['admin'] = "";Limit the access of user “admin” to IP address “”. You can configure as many users as you want.
$config['app']['login']['restrict_ip']['admin'] = "";Limit the access of user “admin” to IP address range “192.168.0.*” using a 24 bit subnet mask.
There are three possible formats that can be used:
1. Wildcard format: 1.2.3.*
2. CIDR format: 1.2.3/24 OR
3. Start-End IP format:
$config['app']['api']['oauth2']['allow_over_http'] = true;Allow OAuth2 to be enabled and used over plain/non-encrypted HTTP.<br>Use this only for testing.
$config['app']['api']['oauth2']['header_access_token_only'] = false;Allows the OAuth2 token to be provided via a POST OR GET variable (“access_token”) instead of the “Authorization” header. <br>Use this only for testing.
$config['app']['logging']['skip_provide_download'] = true;It makes FileRun skip logging the “File downloaded by another user” action. This is useful when you have many users sharing the same home folder.
$config['system']['email_notification']['logging']['expiration'] = 5;Sets the number of days FileRun keeps the e-mail notification logs to 5. The default setting is 2.
$config['app']['email_notification']['basic_actions'] = ['space_quota_warning', 'shared_folder_available', 'receive_copy', 'receive_move', 'receive_upload', 'comment_received', 'provide_download', 'label_set'];These are the default actions FileRun is e-mailing users about when notifications are enabled.


$config['path']['trash'] = '/path/with/write/permission/';Folder to store the trashed files and folders.
$config['path']['thumbnail_cache'] = '/path/with/write/permission/';Folder to store generated thumbnail data in. Make sure you use an absolute path and avoid an empty value at all costs, as it can lead to inadvertent data loss.
$config['app']['metadata']['indexing']['web']['max_files'] = 50;Have FileRun index 50 media files in a single HTTP request. The default is 10.
$config['app']['metadata']['disable_extraction'] = true;Disable the metadata extraction (media indexing) on file upload.
$config['system']['db']['utf8_names'] = true;Force the MySQL connection to use UTF-8.
$config['system']['http']['proxy'] = 'tcp://localhost:3128';Make FileRun use a proxy for downloading software updates.