logseq-selfhost-sync

logseq-selfhost-sync

Docker app from rorar's Repository

Overview

Logseq Sync Server – self-hosted Logseq database synchronization service using the Node Adapter. Provides a private, self-hosted alternative to Logseq's official sync service for managing note synchronization across devices.

Install logseq-selfhost-sync on Unraid in a few clicks.

Find logseq-selfhost-sync in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for logseq-selfhost-sync Review the template variables and paths Click Install
Explore Unraid OS

Requirements

Sync is an beta Logseq feature and only available on Nightly builds at the moment. Create a backup of your local graph first before syncing! Optionally use with a) Tailscale by changing "DB_SYNC_BASE_URL=http://your.tailscale.ip:8787", b) cloudflared + authentication, c) reverse proxy (Nginx Proxy Manager, Traefik) for HTTPS. Cognito credentials are required for JWT validation unless customized.

Categories

Productivity > Other

Related apps

Explore more like this

Explore all
Other apps

Links

Projectlogseq.comSupportgithub.comRegistrygithub.comTemplateraw.githubusercontent.com

Details

Repository
ghcr.io/yshalsager/logseq-selfhost-sync:latest
Registry
https://github.com/users/yshalsager/packages/container/package/logseq-selfhost-sync
Last Updated2026-07-07
First Seen2026-06-29

Runtime arguments

Web UI
http://[IP]:[PORT:8787]
Network
bridge
Shell
bash
Privileged
false
Extra Params
--user 99:100 --tmpfs /tmp --cap-drop=ALL --security-opt=no-new-privileges:true

Template configuration

Port: Sync ServicePorttcp

Logseq Sync Server API port

Target
8787
Default
8787
--- Storage ---Variable

Data storage for synchronization database and assets.

Volume: Sync DataPathrw

Logseq sync database and asset storage. Persists graph data and user information. Using an own share with Custom SMB-Shares Plugin (for specials Chars and Umlauts) on a trusted drive is recommended!

Target
/app/data
Default
/mnt/user/appdata/logseq-selfhost-sync/
--- Sync Configuration ---Variable

Core synchronization service settings.

DB_SYNC_PORTVariable

Port the sync service listens on inside the container

Default
8787
Value
8787
DB_SYNC_BASE_URLVariable

Public URL for sync service. Tailscale: http://ip:8787. Reverse proxy: use HTTPS. See Requires section.

Default
http://localhost:8787
Value
http://localhost:8787
DB_SYNC_DATA_DIRVariable

Path to data directory inside container

Default
/app/data
Value
/app/data
DB_SYNC_STORAGE_DRIVERVariable

Storage driver (sqlite or postgresql)

Default
sqlite
Value
sqlite
DB_SYNC_ASSETS_DRIVERVariable

Assets storage driver (filesystem or s3)

Default
filesystem
Value
filesystem
DB_SYNC_LOG_LEVELVariable

Log verbosity: debug, info, warn, error

Default
info
Value
info
--- Cognito Authentication ---Variable

Logseq Cognito OAuth2 credentials for JWT validation. These are standard Logseq public values.

COGNITO_ISSUERVariable

Cognito issuer URL for JWT validation

Default
https://cognito-idp.us-east-1.amazonaws.com/us-east-1_dtagLnju8
Value
https://cognito-idp.us-east-1.amazonaws.com/us-east-1_dtagLnju8
COGNITO_CLIENT_IDVariable

Cognito client ID for JWT validation

Default
69cs1lgme7p8kbgld8n5kseii6
Value
69cs1lgme7p8kbgld8n5kseii6
COGNITO_JWKS_URLVariable

Cognito JWKS URL for JWT key validation

Default
https://cognito-idp.us-east-1.amazonaws.com/us-east-1_dtagLnju8/.well-known/jwks.json
Value
https://cognito-idp.us-east-1.amazonaws.com/us-east-1_dtagLnju8/.well-known/jwks.json
--- Advanced ---Variable

Advanced security and administration settings. Only modify if you know what you are doing.

DB_SYNC_ADMIN_TOKENVariable

Optional: Long random secret for hardening maintenance/admin endpoints. Leave empty to disable.