Update docs for SQLite warning - #295
Open
ItalyPaleAle wants to merge 2 commits into
Open
Conversation
2 tasks
Contributor
built with Refined Cloudflare Pages Action⚡ Cloudflare Pages Deployment
|
stonith404
approved these changes
Aug 24, 2026
stonith404
reviewed
Aug 24, 2026
Comment on lines
+70
to
+82
| > SQLite is [not designed](https://www.sqlite.org/useovernet.html) to be stored inside networked filesystems, and doing so can cause your database to be corrupted. Because of that, Pocket ID does not support using SQLite on a NFS/SMB share or another networked filesystem. | ||
| > | ||
| > We have received reports from Pocket ID users who experienced a range of issues with SQLite on a networked filesystems, including: | ||
| > | ||
| > - Database operations getting stuck indefinitely | ||
| > - Pocket ID crashing multiple times per day | ||
| > - Irrecoverable database corruption | ||
| > | ||
| > If you absolutely must, some users have found that modifying the connection string `DB_CONNECTION_STRING` to disable journaling (setting `_journal_mode=DELETE`) and limiting to one concurrent connection (`_maxconn=1`) may help. However, treat these as experimental and not guaranteed to succeed. This scenario continues to be unsupported by Pocket ID, and maintainers will not be able to assist with problems. You should also make sure to have recurring backups of your database. | ||
| > | ||
| > Pocket ID will detect if the SQLite database is stored on a networked filesystem and will show a persistent warning in the admin UI. If you're aware of the risks and want to suppress it, set `DISMISS_SQLITE_STORAGE_WARNING=I accept the risks` | ||
| > | ||
| > (Note that this limitation does not apply to block devices mounted from a SAN via iSCSI or a similar protocol, and formatted with a standard filesystem like Ext4 or XFS, which remain supported natively) |
Member
There was a problem hiding this comment.
Suggested change
| > SQLite is [not designed](https://www.sqlite.org/useovernet.html) to be stored inside networked filesystems, and doing so can cause your database to be corrupted. Because of that, Pocket ID does not support using SQLite on a NFS/SMB share or another networked filesystem. | |
| > | |
| > We have received reports from Pocket ID users who experienced a range of issues with SQLite on a networked filesystems, including: | |
| > | |
| > - Database operations getting stuck indefinitely | |
| > - Pocket ID crashing multiple times per day | |
| > - Irrecoverable database corruption | |
| > | |
| > If you absolutely must, some users have found that modifying the connection string `DB_CONNECTION_STRING` to disable journaling (setting `_journal_mode=DELETE`) and limiting to one concurrent connection (`_maxconn=1`) may help. However, treat these as experimental and not guaranteed to succeed. This scenario continues to be unsupported by Pocket ID, and maintainers will not be able to assist with problems. You should also make sure to have recurring backups of your database. | |
| > | |
| > Pocket ID will detect if the SQLite database is stored on a networked filesystem and will show a persistent warning in the admin UI. If you're aware of the risks and want to suppress it, set `DISMISS_SQLITE_STORAGE_WARNING=I accept the risks` | |
| > | |
| > (Note that this limitation does not apply to block devices mounted from a SAN via iSCSI or a similar protocol, and formatted with a standard filesystem like Ext4 or XFS, which remain supported natively) | |
| > SQLite is [not designed](https://www.sqlite.org/useovernet.html) to be stored inside networked filesystems, and doing so can cause your database to be corrupted. Because of that, Pocket ID does not support using SQLite on a NFS/SMB share or another networked filesystem. | |
| > | |
| > We have received reports from Pocket ID users who experienced a range of issues with SQLite on a networked filesystems, including: | |
| > | |
| > - Database operations getting stuck indefinitely | |
| > - Pocket ID crashing multiple times per day | |
| > - Irrecoverable database corruption | |
| > | |
| > Pocket ID will detect if the SQLite database is stored on a networked filesystem and will show a persistent warning in the admin UI. If you're aware of the risks and want to suppress it, set `DISMISS_SQLITE_STORAGE_WARNING=I accept the risks` |
IMO we can shorten this warning.
Contributor
Author
There was a problem hiding this comment.
Yeah fair. Can we still add the mentions of using _journal_mode=DELETE and _max_conn=1? I don't want people to do that, but if they must, it's better than not doing that
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
See pocket-id/pocket-id#1713