alcalbg does not currently provide support for this item.

Popular questions for this item

Request for support

Support for my items includes:
  • Answering questions about the item’s included features and functionality
  • Fixes for bugs and reported issues with the item
  • Providing updates to ensure compatibility with new software versions
Item support does not include:
  • Customization, integration and installation services
  • Help with your particular server configuration or web hosting environment
  • Support for third party software and plug-ins
  • Fixing errors caused by modification to the original files

How can I increase maximum upload file size?

There is a simple variable in FileGator called max_filesize but this will only work within your server limits. If you need to increase server limits see below…

Maximum file upload size is controlled by your web server and PHP settings inside php.ini file.

Follow these steps to increase maximum upload file size to 200MB:

1. Locate your php.ini file. On windows look into c:\Program Files\php\ or c:\xampp\apache\bin\ or simply search for php.ini. Sometimes there are two or more php.ini files (on some xampp installations) so you must figure out which one is used.

2. Inside php.ini file set parameters to something similar:

upload_max_filesize = 200M ;this is 200 Megabytes
post_max_size = 205M ;this must be greater then upload_max_filesize

3. Restart your web server to apply new settings. Don’t forget this!

4. Change FileGator’s configuration.php file around line 46:

'max_filesize' => 209715200, // This is 200 Megabytes

5. Refresh page in your browser and you’re done.

Here is a good link to explain this more deeply.

Note: If you don’t have your own server consult your hosting provider about this.

If you’re stuck with your server’s config you can enable ‘upload in smaller chunks’ feature as described here:

- On Microsoft IIS requestFiltering settings can sometimes block large file uploads

- On some servers you must increase max_execution_time in php.ini as well

- Apache 1.3.x or 2.0.x cannot work above the 2.0GB file limit, as this is something the webserver itself cannot handle due to 32bit register limits. Apache 2.2.x has changed this by using 64bit file registers so you must upgrade to that in order to handle >2GB files. Your LimitRequestBody should also be set to 0 (unlimited) after upgrading as well.

- File size is represented as integer value and the size of php ints is platform dependent, in other words files that are above 2GB can show inaccurate file size on some 32bit systems, windows php installations, 32bit php builds etc.

I cannot change admin password or add new user.

This is a permissions problem, your web server cannot write to /config/config.json file and therefore cannot save users data. Change permissions or file ownership and try again.

when I hit the “folder-structure”-symbol I see a pop-up saying “Please wait…”

It will take some time to generate full tree if you have 50+ folders and it will fail if script execution time is set too low.

You can disable simple_copy_move option (set to false inside index.php) and use cut/copy/paste model without folder structure tree.

This can also happen if you don’t have standard PHP libxml extension installed because FileGator relies on DomDocument class to generate tree view.

Is it possible to grant several users access to the same files?

Absolutely, you can create two (or more) different users on the same folder, one with full permissions and other with read&upload permissions for example.

Even better, you can create one user with full permissions and within this user’s home folder create other users each having one subfolder as a home, this way first user will act as superuser and he can see folders of other users while others cannot go up to superuser folder. See example:


In this case give your superuser access to /filegator/repository/ and he will also see John’s and Maria’s folders.

Is it possible to have a max size for each folder?

This feature is not available but there is a beta functionality currently in testing phase. You can download additional script from here. Put this script inside filegator/config/ folder and it should be executed periodically via cron job, usually every 5 minutes. On top of the script you can set max size limit for directory. This script will search for directories found in users config which exceeds defined size limit and revoke write and upload permissions for users exceeding this size limit.

IMPORTANT: Support and help for this beta feature is NOT available.

Note on nginx servers

Although nginx is not fully tested and supported, it has been reported that FileGator works on those servers just fine.

To increase upload max file size this must be added to nginx configuration:
client_max_body_size 100M;
Because nginx doesn’t use .htaccess rules, in order to prevent php script execution in repository folder – this must be added to nginx config at server section:
location ~* /filegator/repository {
        deny all;
location ~* /filegator/config {
        deny all;

How can I update FileGator?

Once you purchase the script you can update to latest version free of charge. Update instructions:

  • Backup everything.
  • Download the script from CodeCanyon again (
  • Replace all files and folders except “repository” and “config” folder.
  • Check if .htaccess need to be replaced inside “repository” and “config” folder.

For smaller, specific updates please check main page and “Changelog” section for detailed instructions which specific files need to be replaced.

Can I customize the colors and buttons?

You can change colors inside stylesheet CSS file located here:


For example you can change background color by editing 3rd line.

You can also change button colors by editing this CSS file:


Styles for buttons are between lines 602-693

Any way I can force download files? When sending a link to a movie file, for example, the movies starts to play in the browser, instead of being downloaded.

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

Add this to repository .htaccess file and download will be forced for listed extensions.

AddType application/octet-stream .wmv
AddType application/octet-stream .avi
AddType application/octet-stream .mov
AddType application/octet-stream .mp4
AddType application/octet-stream .mp3

Is there a signup functionality?

Yes, this feature is implemented and you only need to switch it on inside configuration file.

Can I upload files in smaller chunks avoiding server’s upload_max_filesize limit?

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

You can activate this by editing 3 files:

filegator/include/blueimp/js/jquery.fileupload.js (around line 101), Set chunk size here:
maxChunkSize: 50000,
filegator/include/blueimp/server/php/upload.calss.php (around line 39), Set this option to false:
'discard_aborted_uploads' => false,
filegator/include/file-gator.php (around line 1322), remove or comment this line so you can set filegator’s max_filesize option to higher value:
gator::error('Config param max_filesize is bigger than php server setting: post_max_size = '.$php_post_max_size.', upload_max_filesize = '.$php_upload_max_filesize);

Clear browser’s cache and you are ready to go. Note that upload in chunks is not available in Microsoft Internet Explorer.

Can I add some actions after file is uploaded? like send an email notification or change the file-name?

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

Yes, look for this line in filegator/include/blueimp/server/php/upload.class.php

move_uploaded_file($uploaded_file, $file_path);

and add you custom code after or before that line, something like this email notification:

mail('', 'Subject', 'New file uploaded');

You can access current user’s parameters such as username, email, homedir or permissions via $_SESSION[‘simple_auth’] variable. See this example:

mail('', 'Subject', "New file uploaded by the user: ".$_SESSION['simple_auth']['username']);
Or this one:
mail('', 'New File Upload', 'New file uploaded by the user: '.$_SESSION['simple_auth']['username']." \r\n Uploaded file: ".$file_path);
More complex example using current SMTP configuration:
$gator = new gator();
$gator->sendEmail('', 'Notification', 'New file uploaded by the user: '.$_SESSION['simple_auth']['username']); // admin
$gator->sendEmail($_SESSION['simple_auth']['email'], 'Notification', 'New file uploaded: '.$file->name); // user

The folders inside “folder structure” are missing or ordered strangely.

Sorting in “folder structure” modal window is not possible due to PHP and RecursiveDirectoryIterator function limitations. It can be done with other functions but it would be very slow, especially when dealing with large and deep directory structures. In other words this is a compromise between speed and usability.

If you have very large or deep directory structures consider using cut-copy-paste model for managing files. Open configuration.php and set ‘simple_copy_move’ to false.

How can I change default sorting?

Default sort is by ‘name’, ascending. If you want to change that open include/file-gator.php and search for this:

$_SESSION['sort']['by'] = 'name';
$_SESSION['sort']['order'] = 1;

you can replace ‘name’ with ‘date’ or ‘size’ and change order to -1 for descending.

You must log out and log in again to apply this changes.

I want to disable sign in process, I just want one user who is always signed in

Open configuration.php file and enable guest account:

'allow_guests' => true,

...then login as admin and give full access rights to the guest.

DO NOT use this setup on public servers since everyone could write to your filesystem

Note on security

Allowing users to access your server and files can lead to security risks. That’s why FileGator has a whole set of security features implemented out of the box reducing that risk to minimum. These features include:

  • Users can login to system only if you grant them access.
  • You can grant read-only permissions and disable upload and write operations.
  • Special .htaccess file inside repository folder prevents users from executing php and other scripts. Check if this is working (see below).
  • Filesystem operations between browser and server can be encrypted with mcrypt function. This can be enabled with config parameter encrypt_url_actions.
  • Users cannot exit their own home folder.
  • In users database file passwords are encrypted. This file is protected with .htaccess and can be stored outside web root folder on secure location. You can also use database for this.

If for some reason you need very strong security you can improve security even more by following these security guidelines:

  • Always use the latest FileGator version.
  • Pick strong passwords for users and admin, disable changing passwords if necessary to prevent users from picking weak passwords.
  • Relocate config/config.json file outside web root folder or use database to store users info.
  • Check if users can execute php scripts by uploading test.php file to user repository. If 403 access forbidden error is thrown when user clicks on test.php file then this security feature is working. Beware that .htaccess works on Apache servers only.
  • Enable url encryption for filesystem actions in config section (encrypt_url_actions = true). When this function is enabled server will accept only encrypted filenames for all operations.
  • Grant access to the users you trust, not everyone.
  • Enable ssl on your server and accept only https connections. This way all communication between user and server will be encrypted. You may need to adjust base_url inside config.
  • Use repository folder outside web root (public server path) and disable “allow_file_links” and “use_lightbox_gallery” in configuration.php
  • Do not use shared hosting or shared servers.
  • Test everything with non-critical data.

And remember, you are solely responsible for your files, server and data. If you have very sensitive data do not use this or any other software or digital storage.

Is there a way I can force the uploaded file to overwrite the current file of the same name?

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

Small code customization is required for this, inside include/blueimp/server/php/upload.class.php replace this:

$file_name = $this->upcount_name($file_name);

with this:


Can I download a folder?

You cannot download entire folder directly but you can zip a folder and download this zip archive instead. See this video tutorial:

Make sure you have zip feature enabled inside configuration.php (‘use_zip’ => true,) which is ‘on’ default.

How can I search through all the folders?

You can filter files in the current folder using search box at the top. To find a file in other folders use the search box inside tree-view.

See this video tutorial:

I’m having problems with filenames containing apostropes, quotes or other special characters

Open configuration.php and set ‘encrypt_url_actions’ to true.

How can I change how long the user will be logged in before session expires?

FileGator respects session lifetime settings defined on your server.

If you wish to change that you can add your custom settings inside filegator/index.php

// session will expire after 1 hour
ini_set('session.gc_maxlifetime', 3600);

Clear your browser’s cookies and try it out.

More info:

Is there a way to share a folder with multiple users?

No, this is not supported.

However, you can tweak the code a little bit and use symbolic links on linux.

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

Open filegator/file-gator.php and replace this line:
if (filetype($directory.DS.$file) == 'dir'){
With this:
if (filetype($directory.DS.$file) == 'dir' || filetype($directory.DS.$file) == 'link'){

Now create a symbolic link in every user folder with

ln -s ../shared_folder

I have problems when dealing with large files and folders

If you’re dealing with large directories with many files or if files are really big then your PHP might need more memory and longer execution time to finish those file operations before it gets killed by the server leaving you with blank page, partially zipped files or similar errors.

You can increase this by adding these two lines in Filegator’s index.php file:

ini_set('max_execution_time', 300); //300 seconds = 5 minutes

This might not work on some shared hosting plans. Their servers are configured to ignore these settings. They can also limit resource consumption in other ways preventing your scripts from taking up too many memory or processor cycles.

Can I link and send users directly to specific folder?

You must tweak this line in include/file-gator.php
header('Location: '.gatorconf::get('base_url').'/?cd=');
to this:
if(isset($_GET['cd'])): $this->changeDirectory(); header('Refresh:0'); else: header('Location: '.gatorconf::get('base_url').'/?cd='); endif; die;
And now you can create links such as

How can I add reCaptcha to the login screen?

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported! You must have allow_url_fopen enabled in your php.ini in order for file_get_contents to work.

Obtain you site key and secret key from here

open include/views/login.php and after this line:
<input type="hidden" name="submit" value="ie_enter_fix"> 
add this code:
<script src="" async defer></script> 
<div class="g-recaptcha" data-sitekey="XXXX"> </div>
replace XXXX with your actual recaptcha site key

Now open include/file-gator.php and after this line:
$user = gator::getUser($_POST['username']);
add this code:
$secret = "YYYY";
$response = $_POST["g-recaptcha-response"];
$ret = json_decode(file_get_contents("".$secret."&response=".$response."&remoteip=".$_SERVER['REMOTE_ADDR']), true); 
if($ret['success'] != true) $errors = lang::get("Wrong Captcha"); 
replace YYYY with your actual recaptcha secret key

I want add a set of same files to each new user

1. create skeleton/ folder inside your main repository folder and add your default files and folders there

2. open include/file-gator.php and search for this:
static function addUser($username, $data){ 
3. add this code after the line above:
$gator = new gator();
$gator->copyRecursively(gatorconf::get('repository').DS.'skeleton', $data['homedir']);

How can I disable direct links? (obsolete)

This faq is obsolete since direct links are now disabled by default.

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

Replace .htaccess file in your repository folder with the one from this archive:

In addition, open configuration.php and set both, ‘allow_file_links’ and ‘use_lightbox_gallery’ to false.

'allow_file_links' => false,
'use_lightbox_gallery' => false,

Note that this will not work on Microsoft IIS / Nginx servers.

Show more