selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

VaultSync logo

Self-host VaultSync

hub-v0.3.0

Obsidian vault sync for iOS using self-hosted Syncthing

BetaOpen SourceMPL-2.0
Updatedlast week
LanguageGo
Setup difficultyModerate
MobileNative app
Stars
149
Ports
22000 (Syncthing sync protocol (TCP+UDP)), 21027 (Syncthing local discovery (UDP)), 8390 (Hub pairing and discovery (TCP+UDP))
Requires
iOS/iPadOS, Obsidian (iOS/iPadOS), Syncthing
Docker
ghcr.io/psimaker/vaultsync-hub
Install with Docker Compose
VaultSync home screen showing sync status, devices and Obsidian vaultsVaultSync welcome screen: Your Obsidian notes, privately syncedVaultSync welcome screenVaultSync home screen

What is VaultSync?

VaultSync keeps Obsidian vaults in sync between iOS devices and a personal server using Syncthing's peer-to-peer engine. The iOS app places notes straight into Obsidian's sandbox. A Docker-based Hub runs on a Linux box or NAS, handling Syncthing, short pairing codes, and an optional notify sidecar that fires APNs silent pushes via a Cloud Relay when the server changes. The core sync is free and open-source under MPL-2.0; Cloud Relay is a paid in-app subscription. The Hub stores vaults as plain files with 30-day versioning and conflict copies, never auto-merging or deleting. Desktop agents for macOS and Linux are also provided. The project is built independently by Umut Erdem.

Should you self-host VaultSync?

VaultSync scores 45/100 on selfhost.directory (how scoring works) and ranks #9 of 15 in File Sync. It has 149 GitHub stars.

It shipped 9 stable releases in the past year. The latest, hub-v0.3.0, came out on 7 October 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MPL-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is NoteDiscovery (62/100, 2 855 stars). It scores higher overall, so compare the two before you pick. See VaultSync vs NoteDiscovery side by side.

Features

  • 30-day versioning and conflict copies
  • Activity timeline and diagnostics
  • Cloud Relay (optional)Requires in-app subscription ($1.99/mo or $14.99/yr)
  • Conflict resolution with diffs
  • Desktop agents (macOS/Linux)
  • Instant upload via Shortcuts
  • Local-first Privacy
  • Multi-language Support
  • Peer-to-peer vault sync
  • QR code pairing
  • VaultSync Hub
  • VoiceOver and Dynamic Type support

VaultSync README

How to install VaultSync

Install VaultSync with Docker Compose

Linux server/NAS with Docker and compose plugin
Environment variables
VAULTSYNC_HUB_DIR, VAULTSYNC_HUB_NAME, VAULTSYNC_HUB_IMAGE, RELAY_URL, PUID, PGID, SYNC_PORT, GUI_PORT, HUB_PORT

curl -fsSL https://vaultsync.eu/setup.sh | sh Choose 2) Hub

Runs on Linux server or NAS with Docker

How to configure VaultSync

  • DEBOUNCE_SECONDS5Debounce time for change detection

    Debounce time for change detection

  • GUI_PORT8384Syncthing Web UI port

    Syncthing Web UI port

  • PGID1000Group ID for container

    Group ID for container

  • PUID1000User ID for container

    User ID for container

  • RELAY_URLhttps://relay.vaultsync.euCloud Relay endpoint URL

    Cloud Relay endpoint URL

  • STARTUP_ANNOUNCEtrueSend startup wake-up to relay

    Send startup wake-up to relay

    values: true/false

  • SYNC_PORT22000Syncthing sync protocol port

    Syncthing sync protocol port

  • SYNCTHING_API_KEYauto-detectedSyncthing API key (auto-detected from config.xml)

    Syncthing API key (auto-detected from config.xml)

  • SYNCTHING_API_URLauto-detected from config.xmlSyncthing REST API URL

    Syncthing REST API URL

  • SYNCTHING_CONFIGstandard locations probedPath to Syncthing config.xml

    Path to Syncthing config.xml

  • SYNCTHING_CONFIG_WAIT_SECONDS60Wait time for Syncthing config.xml on first boot

    Wait time for Syncthing config.xml on first boot

  • VAULTSYNC_HUB_DIR/srv/vaultsyncHub data directory

    Hub data directory

  • VAULTSYNC_HUB_IMAGEghcr.io/psimaker/vaultsync-hub:0.3.0Hub container image

    Hub container image

  • VAULTSYNC_HUB_NAMEVaultSync HubHub display name

    Hub display name

  • VAULTSYNC_HUB_PORT8390Hub pairing port

    Hub pairing port

  • WATCHED_FOLDERSComma-separated folder IDs to watch (empty = all)

    Comma-separated folder IDs to watch (empty = all)

VaultSync releases & version history

More in File Sync

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…