# notes stack — personal knowledge base / PKM backbone. # # CouchDB powers obsidian-livesync for real-time Obsidian vault sync # across LAN/tailnet devices. Vault data lives at /config/couchdb/data on SSD. # # POST-DEPLOY (one-time setup): # 1. Open https://obsidian.ginnoir.com/_utils and sign in as admin. # 2. Settings → CORS → Enable CORS, add origins: # app://obsidian.md # capacitor://localhost # http://localhost # 3. In Obsidian: install the "Self-hosted LiveSync" plugin, # point it at https://obsidian.ginnoir.com with your creds. # 4. Let the setup wizard create the 'obsidian' database. # # Claude integration: # The CouchDB REST API is the read/write surface for the vault. # All notes are docs in the 'obsidian' database. # GET https://obsidian.ginnoir.com/obsidian/_all_docs?include_docs=true # returns all notes; each doc has a 'data' field with the markdown content. services: couchdb: container_name: couchdb image: couchdb:3.4 restart: unless-stopped labels: - "com.centurylabs.watchtower.enable=false" networks: [notes, edge] env_file: - stack.env volumes: - /config/couchdb/data:/opt/couchdb/data - /config/couchdb/etc:/opt/couchdb/etc/local.d ports: - "5984:5984" networks: notes: name: notes driver: bridge edge: name: edge external: true