Common Troubleshooting

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.