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.

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-10-08
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.