- 1 Basic tasks
- 2 File Versioning
- 3 Locking / Unlocking files
- 4 Files Comments
- 5 Files Metadata
- 6 E-mailing Files
- 7 Folder Sharing
- 8 Web Links
- 9 WebDAV
- 10 Windows: Connecting with BitKinex
- 11 MacOS: Connecting with Finder
- 12 Linux: mounting from the command line
Basic tasks
Working with files
Downloading files and folders
To download files right-click them and select “Download” from the contextual menu.
If you select multiple files or a folder, the selected files will be included in one Zip archive.
To download multiple files and folders from different locations at the same time, right-click one of the files or folders and select the “Add to cart” option, under “Download”. Once the download cart is open, you can add more items to it by drag&drop.
Uploading files
To upload files simply use the “UPLOAD” button to start selecting files from your computer, or just drag the files from your computer’s file explorer to the browser, dropping them over the file list area.
For older browsers (older than Internet Explorer 10, Firefox 13, Chrome 20, Safari 6 or Opera 12.1), the following options are available:
Regular
When using “Google Chrome” and “Mozilla Firefox” browsers, this upload method allows you to drag files from your computer on the specified area, to start the file transfer. It works with files up to 4GB. When using “Microsoft Internet Explorer” or “Apple Safari” browsers, Adobe Flash technology is required and files can be uploaded only by selecting them using the “Select Files” option. When using one of these two browsers you can upload files with sizes up to 2GB. Please note that this upload method does not support resuming interrupted uploads and for files larger than a few hundreds of megabytes the “Java” method is still the recommended.
Please follow these steps to upload files using this method:
- Click “Upload” menu option (from FileRun’s top toolbar.)
- Select the “Regular” tab inside the opened window.
- Click “Select Files” to select the files that should be uploaded from your computer. Alternatively, if a “Drag files from your computer here” text is displayed, you can select files in your computer and drag them to the browser over the specified area.
- Click “Upload” button to start the file transfer.
Java
Allows you to upload files and even folders by dragging them from your computer to the browser.
This upload method should be used for very large files, as it supports resuming. You can click here to verify if your browser has the Java support required to use this feature.
Please follow these steps to upload files using this method:
- Click “Upload” menu option (from FileRun’s top toolbar.)
- Click “Yes”, “Allow” or “Confirm” inside the Java security prompt. (The buttons label differs between browsers and operating systems.)
- Drag files from your computer inside the box that reads “Drag files from your computer here”.
- The upload window will automatically close after the transfer completes.
Uploading folders
Using a new version of Google Chrome allows you to upload folders by using the “UPLOAD” button, or by drag&drop. You can upload folders also by:
- Zipping the folder on your computer, uploading the zip archive and unzip the archive on the server once it is uploaded.
- Using the Java upload method to select a folder instead of individual files. If the upload method mentions that you can drag files from your computer to it, you can also drag folders.
Renaming files
To rename a file follow these steps:
- Right-click the file and select “Rename” from the contextual menu.
- Type the new name for the file and click “Ok”.
- The files list will automatically reload to show the changes.
Deleting files
To delete one or multiple files follow these steps:
- Select one file, or multiple files by holding the CTRL key pressed.
- Click the “Delete” option from the contextual menu.
- Click the “Ok” button in the prompt to confirm the action.
- The deleted file(s) will disappear from the list.
Notes: Deleted files can be restored from the “Deleted files” special folder. If you have checked the “Permanent deletion” option the files have been destroyed and cannot be recovered.
Moving files
To move one or multiple files to another folder follow these steps:
- Select one file, or multiple files by holding the CTRL key pressed.
- Drag the file(s) from the list to the target folder on the left tree menu.
- The files list will automatically reload to show the changes.
Copying files
To copy one or multiple files to another folder follow these steps:
- Select one file, or multiple files by holding the CTRL key pressed.
- Click the “Copy” option from the contextual menu.
- Right-click the target folder from the left tree menu and select “Paste copied files”.
- The files list will automatically reload to show the changes.
Creating Zip files
To Zip one or multiple files follow these steps:
- Select one file, or multiple files by holding the CTRL key pressed.
- Click the “Add to zip” option from the contextual menu.
- Type the new name for the new Zip file and click “Ok”.
- The files list will automatically reload to show the changes.
To Zip an entire folder follow these steps:
- Right-click the folder and select “Add to zip”
- Type the name of the Zip file that will be created and click “Ok”
Extracting Zip files
To extract a Zip file follow these steps:
- Select the Zip file
- Click the “Unzip” option from the contextual menu.
- Type the name of the folder that will be used to unzip the files to.
- The folders list will automatically reload to show the changes.
Searching files
To search the currently open folder simple click the “Search” button on the top-left corner of the application. To search in a different folder, right-click the desired folder and select “Search” from the contextual menu. You can search by filename, file text contents (if file indexing is enabled) or by metadata.
Searching by filename
- Search by entire filename, example: “Some Document.xls”
- Search by extension, example “*.xls”
- Search by partial filename, example “Document”
- Search by partial filename and filter by extension: “*Doc*.xls”
Searching by text contents
The field “File contents” should be displayed and editable, to be able to search by text contents. To search for a document containing the word “Invoice”, for example, you can simply type in the word inside the “File contents” field and click “Search”. If you want to search more selectively, however, you can filter your search by specifying Boolean filters. Boolean filters let you combine search words using simple logic, as you can see in the following table.
Filter | Example | Use this to |
AND | building AND project | Find files that contain both words “building” and “project” (even if those words are not right next to each other). |
NOT | building NOT project | Find files that contain the word “building,” but not “project”. |
OR | building OR project | Find files that contain either of the words “building” or “project”. |
Quotes | “building project” | Find files that contain the exact phrase “building project”. |
Wildcard | te?t | Find single and multiple character wildcard searches within single terms. To perform a single character wildcard search use the “?” symbol. To perform a multiple character wildcard search use the “*” symbol. For example, to search for “text” or “test” you can use the search: “te?t”. |
Fuzzy Searches | roam~ | To do a fuzzy search use the tilde, “~”, symbol at the end of a Single word Term. For example to search for a term similar in spelling to “roam” use the fuzzy search: roam~ This search will find terms like foam and roams. |
Proximity Searches | “project china”~10 | Find words which are within a specific distance away. To do a proximity search use the tilde, “~”, symbol at the end of a Phrase. For example to search for a “project” and “china” within 10 words of each other in a document use the search: “project china”~10 |
Searching by metadata
To search the files by a particular metadata value, select the desired field from the “Metadata Field” dropdown menu, type some text in the “Field value” field and press the “Search” button.
Using the search results list
Clicking an item in the search box it will open its folder location and will automatically select it in the main list of files.
Working with folders
Creating new folders
To create a new folder follow these steps:
- Right-click the folder under which you want to create the new folder
- Click the “New sub-folder” option from the contextual menu.
- Type a name for the new folder and press ENTER on the keyboard
To create a new folder under the directory that you are currently browsing you can also use the “New folder” menu option from the top toolbar.
Moving folders
To move a folder you have to select and drag it to the target folder. The folder tree will reload to show the changes.
Renaming folders
To rename a folder follow these steps:
- Right-click the folder and select the “Rename” option from the contextual menu.
- Type the new name for the folder and press ENTER on the keyboard
Hiding folders
To hide a folder follow these steps:
- Right-click the folder and select the “Properties” option from the contextual menu.
- Select the “Properties” option.
- In the window that just opened, click “Add Users” to select the users you want to hide the folder from.
- Select the users and click “Save”
File Versioning
Whenever a file is overwritten, by copying or uploading a file with the same name, a copy of the previous version is automatically stored by FileRun.
Browsing previous file versions
You can browse the previous versions by selecting a file and clicking the “Versioning” contextual menu option.
Restoring / deleting previous file versions
You can delete or restore a previous version by selecting it and clicking the appropriate contextual menu option.
Locking / Unlocking files
To lock or unlock a file follow these steps:
- Select the file
- Select the “Versioning” option from the contextual menu and click the appropriate action.
Locked files can be modified only by the users who locked them.
Files Comments
FileRun provides a tool for attaching user’s comments to files.
To view the comments for a file follow these steps:
- Select the file
- Open the “View” toolbar menu and check the “File preview” checkbox
- Select the “Comments” tab available on the file preview pane.
To add a new comment click the “Add comment” button that ca be found on the bottom toolbar of the commenting area.
To remove a comment from the list select it and click the “Remove comment” button that have been highlighted when you selected the comment.
Files Metadata
FileRun allows you to attach information to files trough the Metadata system. Predefined text fields can be filled in with information by selecting a file and clicking the “Metadata” contextual menu option.
To coose what metadata information to display in the files list, follow these steps:
- Move the mouse over any column header and click the arrow icon that appears on its right side.
- Expand the “Columns” sub-menu and select the columns that you want to display.
E-mailing Files
To send files as e-mail attachments follow these steps:
- Select one file, or multiple files by holding the CTRL key pressed.
- Click the “E-mail” option from the contextual menu.
- Fill in the displayed form’s fields and click “Send”
Instead of attaching the files, to avoid e-mail servers’ limitations, FileRun can also automatically create and attach Web Links to the email. To do that select the “Create and attach WebLinks instead of sending the actual files” checkbox.
To disallow the web access to the files at a later time, you can remove the Web Links as described in the “Web Links” section bellow.
Folder Sharing
To share a folder with other FileRun users follow these steps:
- Right-click the folder you want to share and select the “Share” option from the contextual menu.
- Click the “Add Users” button.
- Select the users or groups of users with which you want to share the folder by clicking their checkboxes.
- Click the “Ok” button.
- Set the permissions you wish to grant to the selected users
- “Upload” – allows the user to upload or paste files or folders in the shared folder.
- “Download/Copy/Preview” – allows access to the existing files’ contents.
- “Add comments” – allows the user to attach comments to the files.
- “Read comments” – allows the user to read comments that are already attached to the files.
- “Move/Rename/Delete” – allows the user to perform various organizational actions on the files available in the shared folder.
- The “Options” tab can be used to share the folder under an alias or to make the folder available to the other users without showing who shared the folder. These options can be different for every selected user or group of users.
- Click “Save”. The folder is now shared.
The shared folders are marked with a small hand icon in the folder tree menu.
Web Links
You can use Web Links to publish photos, videos, or any other file type on Internet websites.
To create a Web Link for a file follow these steps:
- Select the file
- Click the “Web Link” option from the contextual menu.
- Choose to set a password, an expiration period or a download limit. The “Receive e-mail notifications” option can be used if you want to get notified every time somebody downloads the file.
- Click the “Create Web Link” button.
- A text field will be displayed, containing the URL (web address) that can be used to access the file.
Use the displayed form to change the Web Link’s settings or remove the Web Link by clicking the “Remove Web Link” button.
To create a Web Link for a folder follow these steps:
- Right-click the folder and select “Web Link” from the contextual menu.
- Choose to set a password or an expiration period. You can also allow the people accessing the link to upload files in the folder. The “Receive e-mail notifications” option can be used if you want to get notified every time somebody downloads a file from the folder.
- Click the “Create Web Link” button.
- A text field will be displayed, containing the URL (web address) that can be used to access the folder.
Use the displayed form to change the Web Link’s settings or remove the Web Link by clicking the “Remove Web Link” button.
WebDAV
As an alternative to the web browser, FileRun can be also accessed with a standards-compliant WebDAV application. This can be useful for managing the remote files as they were folders on the local computer.
WebDAV client programs tested with FileRun:
Program Name | Operating System | License | Notes |
MacOS Finder | MacOS | – | Guide available down on this page. |
Cyberduck | MacOS | Free | |
WebDrive | Windows/MacOS | Free Trial | Recommended by FileRun! |
NetDrive | Windows | Free For Personal Use | |
Bit Kinex | Windows | Free | |
CloudSafe WebDAV Client | Windows | Free/Unknown | It is designed to work with CloudSafe.com service, but has been successfully tested with FileRun |
IT Hit “Map Drive” | Windows | Commercial | |
GoodSync | Windows/MacOS/Android/iOS | Free/Pro versions | Good for two-ways folder synchronization |
WebDAV File Manager | Android | Free | |
WebDAV Navigator | iOS | Free | |
WebDAV-Sync | Any (Java) | Open-source | Command-line tool for two-ways folder synchronization. Works great. |
DAVbox | Any (Java) | Commercial | Works great for two-ways folder synchronization. |
An example of the URL you need to use to access FileRun’s WebDAV would be: “http://demo.filerun.com/dav.php/” (for our online demo) Please note that the URL must contain the trailing slash character, after “dav.php”.
Note for Apache servers:
If PHP is running as CGI/FastCGI on your server and the HTTP authentication fails, even if you provide valid credentials. If there isn’t already a “.htaccess” file in the root folder of your FileRun installation, create one and make sure it contains the following two lines:
RewriteEngine on RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
Windows: Connecting with BitKinex
- Right-click the “HTTP/WebDAV” folder, select “New” and click “HTTP/WebDAV”.
- Type a name and press enter.
- Type your hostname for the “Server address”. For example, our demo’s hostname is “demo.filerun.com”
- Type the username and password, if you want the program to store it.
- Go to “Site Map” click the default path “/”
- Use the bellow text field to modify “/” to “/dav.php/” (if the FileRun installation is in the root folder of your domain) or “/path-to-filerun-folder/dav.php/” (if the FileRun installation was placed in a subfolder)
- Click “Update” to make the change
- Click “Ok” to close the properties window.
- Double-click on the created connection.
MacOS: Connecting with Finder
Assuming your FileRun instance is installed at https://www.your-site.com/filerun:
In the Finder, choose Go > Connect to Server, type the address of the server in the Server Address field, and click Connect. The server address should be in a form similar to this: ADDRESS/filerun/dav.php/. For our example, it would be:
https://www.your-site.com/filerun/dav.php/
For details, check the respective vendor documentation at the Apple website: http://support.apple.com/kb/PH3857
Linux: mounting from the command line
Install the WebDAV support using the davfs package. On Debian/Ubuntu, you can use:
sudo apt-get install davfs2
Reconfigure davfs2 to allow access to normal users (select Yes when prompted):
sudo dpkg-reconfigure davfs2
Add the users you want to be able to mount the share to the davfs2 group:
sudo usermod -aG davfs2 <user>
Edit /etc/fstab and add the following line for each user who wants to mount the folder (with your details where appropriate):
your-site.com/filerun/dav.php/ /home/<username>/filerun davfs user,rw,noauto 0 0
Then, as each user who wants to mount the folder:
Create the folders filerun/ and .davfs2/ in your home directory
Create the file secrets inside .davfs2/, fill it with the following (with your credentials where appropriate):
your-site.com/filerun/dav.php/ <username> <password>
Ensure the file is only writable by you either through the file manager, or via:
chmod 600 ~/.davfs2/secrets
Run the command:
mount ~/filerun
To automatically mount the folder on login, add the command you used in step 4 to ./.bashrc
Known Issues
Problem: Resource temporarily unavailable
Solution: If you experience trouble when you create a file in the directory, edit /etc/davfs2/davfs2.conf and add:
use_locks 0
Problem: Certificate warnings
Solution: If you use a self-signed certificate, you will get a warning. If you are willing to take the risk of a man in the middle attack, run this command instead:
echo "y" | mount ~/filerun > /dev/null 2>&1