Obsidian Sync Server

A headless Docker container that uses obsidian-headless to keep a local vault directory synchronized with Obsidian Sync.

Quick Start

Clone the repo:

git clone https://gitea-wc4w40kskg0c4g400s0wcgsg.coolify-7dou.ja7z.net/hermes/obsidian-sync-server.git
cd obsidian-sync-server

Configure the Host Path:
- Copy the example env: cp .env.example .env
- Open .env and set VAULT_HOST_PATH to the absolute path of the folder on your computer where you want the notes to live.
  - Correct: /home/user/documents/my-vault
  - Incorrect: ./vault (relative paths can be unpredictable in docker-compose)
Set Sync Credentials:
- Fill in OBSIDIAN_VAULT_NAME and OBSIDIAN_SYNC_PASSWORD (your E2EE key).
Launch:
```
docker-compose up -d
```
First-Time Login: Because Obsidian Sync requires a secure login, you must authenticate the container once:
```
docker exec -it obsidian-sync-server ob login
```
Follow the instructions to log in. The session will be saved in the ./config folder, so you won't have to do this again.

The container runs a continuous sync loop.

Cloud \rightarrow Host: Changes in Obsidian Sync are immediately downloaded to your VAULT_HOST_PATH.
Host \rightarrow Cloud: Any changes you make to the files in VAULT_HOST_PATH (via a local Obsidian app or text editor) are immediately pushed to the cloud.

Variable	Description
`OBSIDIAN_VAULT_NAME`	The name of the remote vault you want to sync
`OBSIDIAN_SYNC_PASSWORD`	Your end-to-end encryption password
`OBSIDIAN_DEVICE_NAME`	The name this device will have in your Sync history
`VAULT_HOST_PATH`	Absolute path to the vault folder on your host machine