WebDAV #

What is WebDAV? #

WebDAV (Web Distributed Authoring and Versioning) is a standard protocol, built on top of HTTP, that lets you read, upload, move and delete files on a remote server as if it were an ordinary network drive. Most modern operating systems — macOS, Windows and most file managers on Linux — have built-in support for it.

By mounting your Brick account over WebDAV, you can work with your files directly in Finder, File Explorer or your favorite file manager — dragging and dropping files just like on a local disk — without opening a browser or installing any extra software.

Creating a WebDAV account #

Once you are logged in to Brick HQ, you can create a WebDAV account like so:

1. Click Settings at the bottom of the sidebar on the left.

2. On the settings page, click the WebDAV tab.

3. Click the Add Account button in the top right.

4. In the dialog that opens ("Add WebDAV Account") you can optionally:

   • give the account a Label so you remember what it is used for, e.g. "MacBook Finder",
   • set your own Password (at least 8 characters) — if you leave the field empty, a random password is generated for you,
   • set an expiry date under Expires.

   Then click Create.

5. Your WebDAV account is now created. If you let Brick generate the password, it is shown here — copy it right away, it is only shown this one time. You also get the WebDAV address (URL) to connect to, ready to copy. Click Done once you have saved what you need.

When you connect a client below, you use your account's email address as the username and the password you just got (or set) as the password.

You can create several WebDAV accounts, for example one per device, and edit the label, password or expiry date at any time — or revoke an account entirely — via the menu button (⋮) next to the row in the list.

Connecting to WebDAV on macOS #

1. Open Finder.
2. In the menu bar, choose Go → Connect to Server… (or press Cmd+K).
3. Paste in your WebDAV address, e.g. https://api.brick.wbite.net/v1/accounts/<your-account-id>/dav (you find the address on the Settings → WebDAV page in Brick HQ).
4. Click Connect and log in with your email address as the username and the WebDAV password you got when you created the account.

If you want to reach the drive quickly again, you can drag the icon that appears on the desktop into Finder's sidebar.

Connecting to WebDAV on Windows #

1. Open File Explorer.
2. Right-click This PC and choose Map network drive…, then click the link Connect to a Web site that you can use to store your documents and pictures at the bottom of the wizard that opens.
3. Paste in your WebDAV address from Settings → WebDAV in Brick HQ.
4. Enter your email address as the username and the WebDAV password as the password when you are asked.

If Windows denies the login despite the details being correct, try clearing saved credentials for the address under Control Panel → Credential Manager and connecting again.

Connecting to WebDAV in GNOME (Linux) #

1. Open the Files (Nautilus) file manager.
2. Choose Other Locations in the sidebar and click Connect to Server at the bottom of the window (or press Ctrl+L to type the address directly).
3. Enter the address with the davs:// prefix instead of https://, e.g. davs://api.brick.wbite.net/v1/accounts/<your-account-id>/dav.
4. Click Connect and enter your email address as the username and the WebDAV password as the password.

The account then shows up under Other Locations and can be bookmarked for quick access.

Mounting WebDAV with rclone (Linux CLI) #

1. Install rclone if you don't already have it, e.g. sudo apt install rclone (see rclone.org for other distributions).

2. Obscure your WebDAV password — rclone's config file should never contain plaintext passwords:

   bash

   rclone obscure '<your-webdav-password>'
   

3. Add a new remote in ~/.config/rclone/rclone.conf (or run rclone config and answer the questions interactively):

   ini

   [brick]
   type = webdav
   url = https://api.brick.wbite.net/v1/accounts/<your-account-id>/dav
   vendor = other
   user = you@example.com
   pass = <obscured password from the step above>
   

4. Test the connection:

   bash

   rclone lsd brick:
   

5. Mount it as an ordinary folder, or use copy/sync directly without mounting:

   bash

   mkdir -p ~/brick
   rclone mount brick: ~/brick --vfs-cache-mode writes
   
   # or, without mounting:
   rclone copy ./localfile brick:/folder/