Drivebase Logo

Hosted WebDAV

Expose Drivebase files through the built-in read-only WebDAV endpoint

Drivebase can expose your workspace through a built-in WebDAV endpoint so desktop clients such as Finder, Windows Explorer, and Cyberduck can browse your files directly.

This is different from the WebDAV storage provider integration. That provider connects Drivebase to an external WebDAV server. Hosted WebDAV does the opposite: it lets external WebDAV clients connect into Drivebase.

What Hosted WebDAV Does

Hosted WebDAV creates standalone credentials inside Drivebase. A WebDAV client connects to the Drivebase server using those credentials and can browse only the files allowed by that credential.

Current behavior:

  • Read-only access only
  • Admin-managed credentials
  • Optional provider restrictions
  • Optional base-path restrictions per provider
  • If no provider restriction is configured, the client sees the merged Drivebase root across all providers in the workspace

Create a WebDAV Credential

  1. Open Settings.
  2. Go to WebDAV.
  3. Click New Credential.
  4. Enter:
    • A credential name
    • A username
  5. Choose provider access:
    • Allow all providers to expose the merged Drivebase root
    • Or disable that option and select specific providers
  6. Optionally set a base path for any selected provider
  7. Create the credential and save the generated password

The password is shown only once.

Connection Endpoint

The WebDAV endpoint is:

https://your-drivebase-host/dav

For local development it may be:

http://localhost:4000/dav

Clients authenticate with:

  • Username: the hosted WebDAV username you created
  • Password: the generated WebDAV password

These credentials are separate from normal Drivebase login credentials.

Permissions and Scope

Each hosted WebDAV credential can be configured in one of two ways:

1. All Providers

If no provider restriction is configured, the client sees the same merged root concept used by Drivebase file browsing.

2. Selected Providers

If one or more providers are selected, the client can access only those providers.

Each selected provider can also be limited to a base path such as:

/Documents

In that case, the client can only browse files inside that subtree.

Client Setup

On macOS, prefer Cyberduck over Finder when possible. Finder is significantly more aggressive with WebDAV probing and background metadata requests, which can lead to noisier behavior and lower compatibility than a dedicated client.

Finder

  1. Open Finder
  2. Select Go > Connect to Server
  3. Enter:
https://your-drivebase-host/dav
  1. Click Connect
  2. Choose Registered User
  3. Enter the hosted WebDAV username and password

Finder can work, but it is not the recommended client for Drivebase-hosted WebDAV.

Windows Explorer

Use Map network drive or Add a network location and enter the same /dav endpoint. Sign in with the hosted WebDAV username and password when prompted.

Cyberduck

Create a new WebDAV connection and use the same endpoint and credentials.

Cyberduck is currently the recommended client for macOS because it behaves more predictably with Drivebase-hosted WebDAV than Finder.

Notes

  • Hosted WebDAV is currently read-only. Write operations are rejected.
  • Folder listings use the same Drivebase metadata and on-demand cache warming model as the web UI.
  • File downloads are streamed through Drivebase from the underlying storage provider.
  • Admins can revoke a credential at any time. Revoked credentials immediately stop working.

On this page