Skip to content

Common Troubleshooting

Jump to bottom
Brycen G edited this page Aug 14, 2025 · 2 revisions

Common Troubleshooting

Saving SnapX.db to a Network Share

If you set SnapX's PersonalFolder to a network share, there are some important considerations to ensure reliability, especially when using SQLite.

Linux (SMB/NFS)

When mounting network shares:

  • SMB:

    • Use SMB3 or later. Older versions (SMB1/2) can cause serious reliability issues with SQLite.
    • Include the strictsync option to ensure write operations are fully committed, which is critical for SQLite integrity.
    • Include the nobrl option to disable byte-range locking, which prevents deadlocks and improves compatibility with SQLite on SMB shares.

  • NFS:

    • Use NFS4 or later. Older versions may lead to similar issues.

Example SMB mount command:

sudo mount -t cifs //hpgaming6900x.local/OpenShare /mnt/OpenShare   -o guest,vers=3.0,uid=1000,gid=1000,file_mode=0777,dir_mode=0777,strictsync,nobrl

Windows

Do not use the built-in NFS3 driver. It is not reliable for SnapX’s SQLite operations.

macOS

Network shares are supported, but I haven't tested them yet on macOS. Good luck! Feel free to edit this page if you find something useful.

Clone this wiki locally