Skip to docs navigation Skip to main content

Documentation

Connecting via WebDAV

This tutorial covers Windows, Mac OS X, and Linux.

We’ll show you how to mount BrickFTP as a drive on your computer.

Note: If you are going to be doing lots of heavy file operations, you may prefer to use a real FTP client as they can be more reliable.

Windows

Open Windows Explorer by going to Start > Computer or pressing Windows + E on your keyboard. Then click Map Network Drive. Your computer may look different depending on what version of Windows you’re using.

Input https://YOURDOMAIN.brickftp.com/ where YOURDOMAIN is the name of your BrickFTP site into the folder field. Then check the “connect using different credentials” box and hit finish.

On the next screen enter your BrickFTP user name and password then hit OK.

If all was entered correctly, the Windows will now show contents of your FTP. You can now browse and access it as any other drive, including via drag and drop.

Mac OS X

We’re going to show you how to open BrickFTP directly in Finder on your Mac using WebDAV.

If you are going to be doing lots of heavy file operations, you may prefer to use a real FTP client, as they can be more reliable.

Important Notice For Using WebDAV with OS X

There are several gotchas when using WebDAV with OS X and Finder. Due to the way Finder operates aggressively with WebDAV, there are a few recommendations that we highly recommend. If you choose not to follow these performance optimization suggestions, you may get unexpected results.

  1. Disable .DS_Store over network connections. You can learn how to do this here.
  2. Disable icon previews. You can learn how to do this here.
  3. Disable 'Allow uploads to overwrite existing files with the same name?' on the configuration page of your BrickFTP site.

Open Finder and and choose Go > Connect to Server, or press ⌘ + K. In the Connect to Server dialog box, enter https://YOURDOMAIN.brickftp.com/ where YOURDOMAIN is the name of your BrickFTP site in the Server Address box and then click Connect.

Make sure you select Registered User on the prompt. Your Mac will ask for your username and password, enter your BrickFTP credentials here. You can select the option to store your login information in your keychain for easy access.

If all was entered correctly, a new Finder window will open containing the contents of your FTP.

You can now browse and access it as any other drive.

Linux (GNOME)

To connect the Nautilus file manager to your BrickFTP site with WebDAV, simply use the path davs://mycompany.brickftp.com, replacing mycompany with your BrickFTP subdomain.

Linux (KDE)

To connect the Dolphin file manager to your BrickFTP site with WebDAV, simply use the path webdavs://mycompany.brickftp.com, replacing mycompany with your BrickFTP subdomain.

Linux (Command Line)

Follow these steps to create a WebDAV mount from the Linux command line:

1) Install the davfs2 WebDAV filesystem driver if not already installed.

Debian/Ubuntu

sudo apt-get install davfs2

CentOS/RHEL/Fedora

sudo yum install davfs2

2) Add yourself to the davfs2 group (afterward, you will need to log out and back in for this to take effect):

sudo usermod -aG davfs2 <username>

3) Create a brickftp directory in your home directory for the mount point, and .davfs2 directory for your personal configuration file:

mkdir ~/brickftp
mkdir ~/.davfs2

4) Copy /etc/davfs2/secrets to ~/.davfs2, set yourself as the owner, and make the permissions read-write owner only:

sudo cp /etc/davfs2/secrets ~/.davfs2/secrets
sudo chown <username>:<username>  ~/.davfs2/secrets
sudo chmod 600 ~/.davfs2/secrets

5) Add your BrickFTP site URL and login credentials to the end of the secrets file:

https://mycompany.brickftp.com <username> <password>

6) Add the mount information to /etc/fstab:

https://mycompany.brickftp.com /home/<username>/brickftp davfs rw,user,noauto 0 0

7) You should now be able to mount your BrickFTP site with WebDAV using this command:

mount ~/brickftp