WebDAV-SYNC

A Local-First, Open-Standard Synchronization Plugin for Obsidian. WebDAV-SYNC focuses exclusively on the WebDAV protocol to provide a self-hosted synchronization solution to sync in mobile.

WebDAV-SYNC is a refocused fork of the original Remotely-Save project, optimized for open standards and local network independence.

Disclaimer & Caution
Installation
Configuration
Encryption
Contributing & Support
License

Disclaimer & Caution

This is NOT the official Obsidian Sync service.
ALWAYS backup your vault before using any synchronization plugin.
Synchronization involves complex file operations; use at your own risk.

Installation

Since this plugin is not yet available in the official Obsidian Community Plugin gallery, you must install it using one of the following methods:

Option 1: Using BRAT (Recommended)

Install the BRAT plugin from the Obsidian community gallery.
Go to Settings > BRAT > Beta Plugin List > Add Beta Plugin.
Enter the repository URL: https://github.com/lucaspereirasouza/WebDAV-SYNC
Click Add Plugin.

Option 2: Manual Installation

Go to the Releases page.
Download the latest main.js, manifest.json, and styles.css.
Create a folder named webdav-sync in your vault’s .obsidian/plugins/ directory.
Move the downloaded files into that folder.
Restart Obsidian and enable the plugin in Settings > Community Plugins.

Configuration

1. Enable the Local Server (Optional)

If you want to sync your current vault to other devices on your local network:

Go to Settings > WebDAV-SYNC.
Enable Local WebDAV Server.
Note the displayed IP Addresses and the Port.
Set a strong Username and Password.

2. Configure the Remote Client

To sync with an external server or another device’s local server:

In settings, ensure the service is set to webdav.
Enter the Server Address (e.g., http://192.168.1.100:36666 for a local server).
Enter your credentials.
Test the connection and trigger a Manual Sync via the ribbon icon.

Encryption

If you specify a password in the encryption settings, all files will be encrypted using AES-256-CBC before being uploaded. This ensures that even if your WebDAV provider is compromised, your data remains unreadable.

Contributing & Support

Contributions are welcome! Please feel free to open an issue or submit a Pull Request if you have any suggestions or find any bugs.

Issues: Report bugs or request features on GitHub.
Discussions: Share configurations and tips in the Discussions section.

License

This project is licensed under the MIT License. See the LICENSE file on the repository for details.

# WebDAV-SYNC