Skip to content
This repository has been archived by the owner on Jan 6, 2024. It is now read-only.
/ obi-sync Public archive

Reverse engineering of the native Obsidian sync and publish server

License

Notifications You must be signed in to change notification settings

acheong08/obi-sync

Repository files navigation

Rev Obsidian Sync

Reverse engineered obsidian sync server (NOT OFFICIAL).

Warning

The main branch is the development branch. For stable usage, use the latest release.

Note

The plugin is broken on obsidian >= 1.4.11. This is intentional by the official ObsidianMD team. They have made clear their dissatisfaction with this project. The Path Forward - We are in the early stages of designing an alternative plugin that does not make use of existing code by ObsidianMD team. It is still in the design phase and help is needed. For now, we can manually patch the files from https://github.com/obsidianmd/obsidian-releases/releases/. I will write up a wiki page or automate that soon.

Features

  • End to end encryption
  • Live sync (across devices)
  • File history/recovery/snapshots
  • Works natively on IOS/Android/Linux/MacOS/Windows... (via the plugin)
  • Vault sharing
  • Publish (markdown only. no rendering yet)

Experimental

These features are not in the latest release but in the main branch. They might not be fully tested and are probably unstable.

  • N/A

To do

  • Fix bugs
  • Improve publish

Quickstart

Note

The comprehensive documentation by @Aetherinox can be found in the wiki.

Quickstart with Docker

Environment variables

Required:

  • DOMAIN_NAME - The domain name or IP address of your server. Include port if not on 80 or 433. The default is localhost:3000

Optional

  • ADDR_HTTP - Server listener address. The default is 127.0.0.1:3000
  • SIGNUP_KEY - Signup API is at /user/signup. This optionally restricts users who can sign up.
  • DATA_DIR - Where data is saved. Default .
  • MAX_STORAGE_GB - The maximum storage per user in GB. Default 10
  • MAX_SITES_PER_USER - The maximum number of sites per user. Default 5

Building & Running

  • git clone https://github.com/acheong08/obsidian-sync
  • cd obsidian-sync
  • go run cmd/obsidian-sync/main.go

Optional:

  • Configure nginx
  • HTTPS is recommended.

When you're done, install and configure the plugin

Adding a new user

go run cmd/signup/main.go

Alternatively:

curl --request POST \
  --url https://yourdomain.com/user/signup \
  --header 'Content-Type: application/json' \
  --data '{
	"email": "[email protected]",
	"password": "example_password",
	"name": "Example User",
	"signup_key": "<SIGNUP_KEY>"
}'

You can set the signup key via the SIGNUP_KEY environment variable. If it has not been set, you can exclude it from the request.