Where Does SiYuan Store Workspaces and Notes?
Where SiYuan keeps its workspace folders with conf.json settings, notebooks, and assets on desktop.
Last updated
SiYuan stores everything in a user chosen workspace folder: conf/conf.json for workspace settings, data/ for notebooks as .sy JSON files, plus history, repo, and temp trees. An app level ~/.siyuan/conf.json holds account and window state.
The workspace is self contained by design, which makes migration a folder copy. The trap is backing up temp/ indexes instead of data/ sources: temp rebuilds, data does not. The data repo key for sync travels separately through account settings.
Where SiYuan stores this, by platform
<workspace>/conf/conf.json + data/
conf/conf.json for settings, data/<box-id>/ for notebooks, history/ and repo/ for versions. The workspace path is your choice at first launch; Docker mounts it at /siyuan/workspace. Close the app before copying.
<workspace>\conf\conf.json + data\
Same workspace layout as Linux with your chosen root (default beside the install). Microsoft Store builds behave identically for file purposes. The workspace list itself lives in the app level config.
Frequently asked questions
how do i move siyuan to a new computer
Copy the whole workspace folder (conf/, data/, history/, repo/) to the new machine and open it there. Notebooks, assets, plugins, and settings travel together. The data repo key for sync lives separately in account settings, so export that too.
where is the siyuan config file
In conf/conf.json at the workspace root (appearance, editor, sync, repo options). Each notebook adds its own .siyuan/conf.json for BoxConf. The app level ~/.siyuan/conf.json holds window and account state. Edit the workspace one for behavior changes.
where are siyuan notes stored
As .sy JSON files in data/<notebook-id>/ folders with assets beside them. The temp/ indexes (siyuan.db) rebuild from those files, so never back up temp/ instead of data/. Copy data/ with SiYuan closed for a consistent snapshot.
Notice an outdated path? Let us know.