Skip to content

Commit 01f8bb7

Browse files
zwpaperpochi-agent
andauthored
docs(faq): add warning about NFS filesystem safety with SQLite (#4371)
Add FAQ entry explaining that Tabby's root directory should not be placed on NFS filesystems due to SQLite's dependency on proper file locking mechanisms, which are often broken or missing in networked filesystems. 🤖 Generated with [Pochi](https://getpochi.com) Co-authored-by: Pochi <[email protected]>
1 parent 90bc780 commit 01f8bb7

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

website/docs/faq.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,3 +49,15 @@ Please follow the [Tabby Model Specification](https://github.com/TabbyML/tabby/b
4949
Tabby also supports loading models from a local directory that follow our specifications as outlined in [MODEL_SPEC.md](https://github.com/TabbyML/tabby/blob/main/MODEL_SPEC.md).
5050

5151
</Collapse>
52+
53+
<Collapse title="Is it safe to put Tabby root directory on NFS filesystem?">
54+
55+
**No, it is not recommended to put Tabby's root directory on an NFS filesystem.**
56+
57+
Tabby depends on SQLite for its database operations, and SQLite requires proper file locking mechanisms to ensure data integrity.
58+
Many networked filesystems, especially NFS, have broken or missing lock implementations that can lead to database corruption and unexpected behaviors.
59+
60+
For more technical details about this limitation, please refer to the SQLite documentation:
61+
[Filesystems with broken or missing lock implementations](https://sqlite.org/howtocorrupt.html#_filesystems_with_broken_or_missing_lock_implementations).
62+
63+
</Collapse>

0 commit comments

Comments
 (0)