This guide walks you through syncing a local-first writing app (like Obsidian, Logseq, or Zettlr) across your devices, so you can write anywhere without losing your privacy or your work. You’ll set up a secure, versioned sync that survives crashes, accidental edits, and even a stolen laptop. No cloud subscription required — just a free sync tool and a few minutes of setup.
What You’ll Need
- A local-first writing app that stores files as plain text or Markdown (check your app’s documentation).
- A free or low-cost cloud storage account: Dropbox, Google Drive, OneDrive, or a self-hosted option like Nextcloud.
- For end-to-end encryption (strongly recommended): a tool like Cryptomator (free, open-source) or an encrypted container from VeraCrypt.
- For versioning and conflict resolution: a Git account (GitHub, GitLab, or Bitbucket) — optional but very helpful.
- At least two devices (laptop, desktop, phone, tablet) with the same writing app installed.
Step-by-Step
- Choose your primary device. Pick the device where you’ll do most of your writing. Create a dedicated folder for your notes, e.g.,
~/WritingorD:\Notes. - Set up your sync folder. Install your cloud storage client on the primary device and create a folder inside it, e.g.,
MyCloud/WritingApp. This folder will be the hub for all devices. - Move your writing vault into the sync folder. If you already have notes, move the entire vault folder into the cloud sync folder. If starting fresh, create a new vault there.
- Enable encryption (recommended). Install Cryptomator on the primary device. Create a new vault and point it to the cloud sync folder. Set a strong master password (use a password manager). Mount the vault and copy your writing folder into it. Now your files are encrypted before they ever hit the cloud.
- Set up versioning (optional but smart). If you use Dropbox or Google Drive, enable version history in their settings (usually 30 days). For Git-based versioning, initialize a Git repository inside your writing folder (even inside the encrypted vault) and push to a private remote. Commit after each writing session.
- Install the writing app on your second device. Download the same writing app on your laptop, phone, or tablet.
- Connect the second device to the same cloud folder. Install the cloud client on that device and log in with the same account. If using Cryptomator, install it there too, open the vault with the same password, and you’ll see your encrypted files.
- Open your vault from the synced folder. In the writing app on the second device, open the folder that lives inside the cloud sync folder (or inside the mounted Cryptomator vault). Do not create a new vault — open the existing one.
- Test sync. On device A, create a test note and write a sentence. Wait 30 seconds, then check device B. The note should appear. Edit it on B, then check A. If both work, you’re syncing.
- Set up conflict handling. Most writing apps create a conflict copy (e.g.,
note (conflicted).md) when two devices edit the same file. Decide on a workflow: always close a file before switching devices, or wait for sync to finish before editing on another device.
Common Mistakes
- Syncing the app’s database instead of the folder. Some apps (like Notion) use a database, not plain files. Local-first apps work best with plain text/Markdown. If you use a database app, sync via its built-in feature, not a file folder.
- Forgetting to encrypt. Syncing unencrypted notes to a cloud service means the provider can read your writing. If privacy matters, always use Cryptomator or similar.
- Ignoring conflicts. If you edit the same note on two devices before sync finishes, you’ll get a conflict file. Don’t delete it immediately — merge the changes first.
- Using a sync tool that doesn’t support file locking. Some tools (like Dropbox) handle concurrent edits poorly. If you write on multiple devices at the same time, use a tool with file locking (like Syncthing) or accept the conflict copies.
- Not backing up separately. Cloud sync is not a backup. If you accidentally delete a file and the deletion syncs, it’s gone from all devices (unless versioning is on). Keep a separate backup, e.g., an external drive.
Tips
- Use a naming convention. Prefix notes with dates (e.g.,
2025-03-14-idea.md) to avoid duplicate names and make sorting easier. - Enable two-factor authentication on your cloud account and Git remote. This prevents unauthorized access to your notes.
- Set your writing app to auto-save. Most local-first apps do this by default. If not, enable it so you don’t lose work.
- Use a single master password for Cryptomator and store it in a password manager. Losing it means losing access to your encrypted notes forever.
- If you use Git, commit often. A commit after each writing session gives you a restore point. Use meaningful commit messages like “added chapter 3 draft”.
- For mobile, use the app’s built-in sync if available. Some writing apps (like Obsidian) have a paid sync service that handles encryption and conflicts automatically. If you prefer simplicity, that’s a valid option.
Troubleshooting
- Changes not appearing on the other device. Check that both devices are connected to the same cloud account. Wait a few minutes; some sync clients have a delay. If using Cryptomator, ensure the vault is mounted and the cloud folder is inside the vault (not outside).
- Conflict files appearing constantly. This happens when you edit the same file on two devices before the first edit syncs. Make a habit of closing the file and waiting for the sync icon to show “up to date” before switching devices. If the problem persists, use a sync tool with file locking (like Syncthing).
- Cryptomator vault won’t open on the second device. Double-check the password (case-sensitive). Ensure you copied the vault folder correctly — the vault is a folder with a
masterkey.cryptomatorfile inside. If you moved it, the path may have changed. - Sync is very slow. Large attachments or many small files can slow down cloud sync. Try compressing images or moving large media out of the vault. For many files, use a tool like Syncthing that syncs directly between devices.
- Accidentally deleted a note and it synced everywhere. If you have versioning enabled in your cloud client, restore the file from the version history. If you use Git,
git checkout -- <file>to revert. Without versioning, you may need a separate backup. - App shows “vault not found” on the second device. The path to your vault changed. In the app, close the current vault and open the folder from the correct location (e.g., the mounted Cryptomator drive).
Frequently Asked Questions
Can I use iCloud or OneDrive instead of Dropbox? Yes, any cloud storage that keeps files locally on disk works. iCloud on Windows can be finicky, but on Apple devices it’s fine. OneDrive works well on Windows. Just make sure the folder is always available offline (not “online-only”).
Is it safe to sync unencrypted notes to Google Drive? It’s safe from data loss, but Google can technically read your files. If you write anything sensitive (diaries, drafts of unpublished work), use encryption. For casual notes, it’s usually fine.
What if I want to sync my phone and laptop? Install the cloud client on your phone (e.g., Dropbox app) and open the vault from there. Some writing apps (like Obsidian) have mobile apps that can open a local folder. If you use Cryptomator, there’s a mobile app too, but it’s less convenient — you may prefer a simpler setup for mobile.
Do I need a Git account for versioning? No, Git is optional. Cloud storage version history is enough for most writers. Git is useful if you want granular versioning and branching (e.g., for a novel). If you’re not comfortable with the command line, stick with Dropbox/Drive.
What happens if I edit the same note on two devices at the same time? You’ll get a conflict file (e.g., note (conflicted copy).md). You’ll need to manually merge the changes. To avoid this, always close a note before switching devices, and wait for sync to complete.
Can I use Syncthing instead of a cloud service? Yes, Syncthing is a free, open-source tool that syncs directly between devices without a cloud server. It’s more private and faster, but requires both devices to be online at the same time. It also handles conflicts well. If you’re comfortable with a bit of setup, it’s a great choice.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- Google Photos Backup Stuck? Fixes That Work
- Record Your Own Alarm Sound on Android
- Transfer Music from ZTE to iPhone: Full Guide
- Angel Investor vs Venture Capitalist: Key Differences
- Sync Apps Between Android Devices Using Google Play
- Find What Drains Your iPhone Battery Fast