Accessing via WebDAV
Using 2FA or third-party authentication? Use theConnect app
option to generate a new set of credentials for your account.
As an alternative, FileRun can be also accessed with a standards-compliant WebDAV application. This can be useful for managing the remote files as they are folders on the local computer.
WebDAV client programs tested with FileRun:
Program Name | Operating System | License | Notes |
---|---|---|---|
Windows Explorer | Windows | Our opinion: only if you don't have other options | |
MacOS Finder | Mac | Our opinion: decent solution | |
Linux | Linux | ||
Rclone | Linux Mac Windows | Our opinion: very good! | |
Cyberduck | Windows Mac | Free | Our opinion: decent solution |
WinScp | Windows Mac | Free | |
GoodSync | Windows Mac iOS | Free/Pro versions | Good for two-ways folder synchronization |
FE File Manager | iOS | Free | Recommended by FileRun! |
WebDAV Navigator | iOS | Free | |
WebDrive | Windows Mac | Commercial | Our opinion: good |
NetDrive | Windows Mac | Commercial | Our opinion: good |
An example of the URL you need to use to access FileRun's WebDAV would be: https://demo.filerun.com/dav.php/
(for our online demo)
Please note that the URL must contain the trailing slash character, after “dav.php”.
When using Nextcloud desktop sync app, the URL should be the root of your FileRun installation (example:https://demo.filerun.com
). Do not append “/dav.php/” to it.
Windows: Connecting with Explorer
Please note that Windows will not connect to your server if it is not serving via HTTPS with a valid SSL certificate.
- Open
This PC
- Right-click the empty space and select
Add a network location
. - Type in the URL of your FileRun installation, like this: https://www.your-website.com/filerun/dav.php/ (The highlighted part is the important part which needs to be appended to the FileRun URL)
- You will be prompted for your FileRun account's username and password.
- Use the convenient
Connect app
option from the FileRun interface (next to theSign out
option in the FileRun menu) to generate credentials.
To mount My Files
directly, append %40Home/
to the above URL.
If the above fails, try also this method:
- Open a “Command Prompt”
- Run
net use * https://www.your-website.com/filerun/dav.php/
(Replace with your actual URL)
MacOS: Connecting with Finder
Assuming your FileRun instance is installed at https://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. For our example, that would be:
https://your-site.com/filerun/dav.php/
rclone
When configuring FileRun to be used with rclone, make sure you use it in Nextcloud
mode with the URL configured like this:
https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/
This will have rcloud preserve the files modification times when syncing to FileRun.
Tip: use the –create-empty-src-dirs
command flag to make sure rclone preserves empty folders.
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 ./.coderc
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
Troubleshooting
Login loop
If the user credentials are not being accepted despite being correct, make sure the server environment variable “HTTP_AUTHORIZATION” is being populated by the web server. On Apache web servers, the configuration line would look like this:
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
NGINX - No XML
The default NGINX with PHP-FPM configuration breaks URLs such as /dav.php/some/path
.
Please see this section: http://blog.filerun.com/how-to-install-filerun-on-ubuntu-20-with-nginx/#step7configurenginxwithphp
IIS - 405 Method Not Allowed
Step 1: Open IIS Manager
Open the Start menu and type “IIS” into the find box. You should see an application called Internet Information Services (IIS) Manager
.
On the left, there is a Connections
pane. You should see your computer listed here. Click on your computer name which should load a dashboard with a handful of icons.
Step 2: Open PHP Handler Mapping
Double-click on the Handler Mappings icon to bring up the Handler Mappings screen.
Then double-click on the handler for PHP files to bring up the Edit Module Mapping
window:
Step 3: Edit Verbs
Click on the Request Restrictions
button, then switch to the [Verbs]
tab. Switch the radio button to All Verbs
, then click OK
to close the window, then OK
again to close the other window.
If the problem persists
- Open
WebDav Authoring Rules
and then select theDisable WebDAV
option present on the right bar. - Select
Modules
, find theWebDAV Module
and remove it. - Select
HandlerMapping
, find theWebDAVHandler
and remove it. - Restart IIS.