WebDAV Early Access Guide for Linux

Important:

July 15, 2026: Please note WebDAV for Linux is currently available in early access to invited users only. We will gradually expand the program over the coming weeks and months as we work toward an official launch.

The instructions and software described in this article will NOT work for accounts that haven't been enrolled in the program.

If you are interested in participating, please fill out this form to be added to the waitlist, and contacted if a spot becomes available.

Prerequisites
What is Sync WebDAV?
How to install the WebDAV server
Connecting to Sync using a WebDAV client
Terminal commands
FAQs

Prerequisites

Before getting started, ensure you have:

Been invited to the early access program. See above.
A Linux system, Ubuntu 22.04 or Ubuntu 24.04 recommended
A test account dedicated to testing

What is Sync WebDAV?

Sync WebDAV for Linux lets you access your Sync files through any WebDAV-compatible client by running a local WebDAV server on your own machine. Instead of connecting directly to Sync’s servers through WebDAV, your WebDAV client connects to localhost, while the local server securely connects to Sync and preserves end-to-end encryption (E2EE).

How to install the WebDAV server

Follow the steps below to install the Sync WebDAV server on your Linux device.

Open Terminal.

Open the Terminal application on your Linux device.
- Ubuntu 22.04: Click the Grid icon in the dock and open Terminal.
- Ubuntu 24.04: Click the Ubuntu icon in the dock and open Terminal.
Install the Sync WebDAV Server.

Copy and paste the following install command into Terminal:
```
curl -LsSf https://www10.sync.com/download/webdav/install.sh | sh
```
If you receive a Curl-related error, run the following commands and then try the installation again:
```
sudo apt-get update
```
```
sudo apt install curl
```
Restart Terminal.

After the installation completes, close the Terminal window completely and then open a new Terminal window.
- This step is required because the installer creates a command shortcut that becomes available only after Terminal has been restarted.
Sign in to Sync.

In the new Terminal window, run:
```
sync-webdav
```
Sign in to your early access Sync account when prompted. Note: sign in will fail unless you have registered an account for early access.
Confirm the server is running.

After successfully signing in, you will see:
```
Sync WebDAV Server running at http://127.0.0.1:4918/
```
Important: Leave the Terminal window open while using Sync WebDAV. The WebDAV server runs within the Terminal session, so closing the window will stop the server and end any active connections.

Connecting to Sync using a WebDAV client

Several Linux tools can connect to WebDAV servers, including Files, davfs2, and Rclone. The Linux Files app provides the easiest setup and is ideal for everyday file browsing and document editing. If you're working with large uploads, transferring many files at once, or prefer using the command line, Rclone is the recommended option.

Before proceeding, ensure the Sync WebDAV server is running.

Connecting with the Linux Files app

Open the Files application on your Linux system.
In the left sidebar, select Other Locations.
In the Connect to Server field, enter:
```
dav://127.0.0.1:4918/
```
Click Connect.

Your Sync account will now appear in the Files app, allowing you to browse and access your files.

Mounting Sync WebDAV with Rclone

Open Terminal.

Open the Terminal application on your Linux device.
Install Rclone.

If Rclone is not already installed, run one of the following commands:

Ubuntu or Debian:
```
sudo apt install rclone
```
Or install the latest version directly from Rclone:
```
curl https://rclone.org/install.sh | sudo bash
```

Configure Rclone.

Create a config in Rclone for the WebDAV server:

rclone config create sync-webdav webdav url=http://localhost:4918 vendor=other

Create a mount folder.

This folder will be used as the location where your Sync files appear on your device.
```
mkdir -p ~/sync-drive
```

Start the Sync WebDAV server.

Run:
```
sync-webdav
```
When prompted, sign in using the Sync account email address that was approved for WebDAV testing.

By default, the Sync WebDAV server uses port 4918. If needed, you can specify a different port:
```
sync-webdav --port <port>
```
Leave this Terminal window open while using WebDAV.

Mount Sync using Rclone.

In a second Terminal window, mount your Sync files by running:
```
rclone mount sync-webdav:/ ~/sync-drive --daemon
```
Your Sync files will now be available in the ~/sync-drive folder.

Optional: Run Rclone in the foreground for troubleshooting.

If you want to view Rclone activity or troubleshoot mounting issues, run:
```
rclone mount sync-webdav:/ ~/sync-drive --vfs-cache-mode writes
```
Press Ctrl+C to unmount when running in the foreground.

Note: The Sync WebDAV server must remain running while the Rclone mount is active. Closing the Terminal window running sync-webdav will disconnect the mount.

Terminal commands

Sync WebDAV includes several optional command-line settings that let you customize how the server runs. While you can get started using the default configuration, these commands give you additional control over settings such as the WebDAV port, mounted folder location, logging, saved profiles, and background operation. The table below provides an overview of the available login, profile management, and advanced command options.

Login and profile commands

Use the login and profile commands to sign in, save your Sync session, view saved profiles, or remove a saved session from your device.

Command	Description	Example
`login`	Signs in to your Sync account and saves your session.	`sync-webdav login`
`login --profile <name>`	Signs in and saves the session under a specific profile name.	`sync-webdav login --profile work`
`login --list`	Displays all saved profiles on your device.	`sync-webdav login --list`
`logout`	Removes the saved session for the default profile.	`sync-webdav logout`
`logout --profile <name>`	Removes the saved session for a specific profile.	`sync-webdav logout --profile work`

Advanced command options

Use the advanced command options to customize how Sync WebDAV runs, including the port, mounted folder location, display name, logging, profiles, and background operation.

Command	Short	Description	Example
`--help`	-	Displays all available commands and options.	`sync-webdav --help`
`--version`	-	Displays the installed Sync WebDAV version.	`sync-webdav --version`
`--port <number>`	`-p`	Changes the port used by the WebDAV server. Default: 4918.	`sync-webdav --port 8080`
`--mount <path>`	`-m`	Exposes a specific Sync folder or Vault location through WebDAV.	`sync-webdav --mount Documents`
`--label <name>`	`-l`	Changes the display name shown in WebDAV clients.	`sync-webdav --label "My Sync Files"`
`--verbose`	`-v`	Enables detailed logging for troubleshooting.	`sync-webdav --verbose`
`--daemon`	-	Runs Sync WebDAV in the background.	`sync-webdav --daemon`
`--profile <name>`	-	Uses a specific saved profile when starting WebDAV.	`sync-webdav --profile work`
`--config <path>`	`-c`	Uses a custom configuration file.	`sync-webdav --config /path/to/config.ini`
`--log-file <path>`	-	Saves log output to a file.	`sync-webdav --log-file webdav.log`
`--upload-temp-dir <path>`	-	Uses a custom temporary directory for uploads.	`sync-webdav --upload-temp-dir /tmp/webdav`

FAQs

How do I submit a bug?

If you encounter an issue while testing WebDAV, please contact the support team and provide as much detail as possible, including:

A description of the issue
Steps to reproduce the behavior
Any error messages displayed
Screenshots or screen recordings, if available
Your Linux distribution and version

How do I update to the latest WebDAV version?

Run the installer again:

curl -LsSf https://www10.sync.com/download/webdav/install.sh | sh

If Sync WebDAV is already installed, running the installer will update your existing installation to the latest available version.