This repo aims to help Logseq users to sync their data via Git and GitHub.

From the above diagram, it's pretty obvious that Git is the most robust way to sync your graph. iCloud is slow and problematic, and Syncthing is not available on iOS/iPadOS.

However, Git is quite scary for non-programmers, so this doc is here to help!

Please check Prerequisite and get yourself a cup of coffee ☕.

Please check Workflow.

Please check Windows.

Please check macOS.

Please check iOS/iPadOS.

Please check Android.

Please check FAQ.

• 2024-04-18: Add ssh config in Workflow to avoid Permission denied:(publickey) issue.
• 2023-12-27: Fix For Android users Termux path to ~/storage/shared to avoid issue#34.
• 2023-11-21: Update For iOS/iPadOS users (Working-Copy) for updated version of Working Copy.
• 2023-10-21: Add deprecation warning at For iOS/iPadOS users (a-Shell-Deprecated)
• 2023-10-12: Add Why and how to fix error: "fatal: not in a git directory"? to FAQ.
• 2023-01-09: Add a-Shell support for iOS/iPadOS users as a free althernative.
• 2022-11-01: Update Prerequisite, For macOS users, For Android users, FAQ wiki.

• Working Copy on iOS, by @danieltomasz¹.
• Steps to auto sync iOS + Windows, by @Caps².
• Gitea - self-hosted git server, by @Sawhney³.
• Self Managed Sync + Android setup, by @danzu⁴ and @Abulafia⁵.
• Git hooks settings
• What is GitHub?
• How does Git work?
• Repository size limits for GitHub.com
• About large files on GitHub
• Differences between CRLF and LF, in Chinese.
• Alternative way of git syncing on iOS using a-shell for free, by Petrus Hyvönen⁶.
• [Tutorial] How to enable automatic logseq graph sync on iOS with git & shortcut, by @sickmz⁷.

Credits to @danieltomasz¹, @Sawhney³, @Caps², @Abulafia⁵ @qwxlea⁴ for the workflow build up. And credits to @danzu⁸ for the incredible diagram!

FYI, those IDs are IDs in Logseq Discord Server if not specified.