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
- Open Settings.
- Go to WebDAV.
- Click New Credential.
- Enter:
- A credential name
- A username
- Choose provider access:
- Allow all providers to expose the merged Drivebase root
- Or disable that option and select specific providers
- Optionally set a base path for any selected provider
- Create the credential and save the generated password
The password is shown only once.
Connection Endpoint
The WebDAV endpoint is:
https://your-drivebase-host/davFor local development it may be:
http://localhost:4000/davClients 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:
/DocumentsIn 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
- Open Finder
- Select Go > Connect to Server
- Enter:
https://your-drivebase-host/dav- Click Connect
- Choose Registered User
- 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.