From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Fri, 14 Mar 2025 20:07:03 +0000 (-0700)
Subject: Merge branch 'main' into beta
X-Git-Tag: v2.15.0^2~13^2~17
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0c9d615f56dcae7dd5e3bf209db2d024c246c326;p=thirdparty%2Fpaperless-ngx.git

Merge branch 'main' into beta
---

0c9d615f56dcae7dd5e3bf209db2d024c246c326
diff --cc docs/setup.md
index 75754766ee,9413ec1040..7bb71a761f
--- a/docs/setup.md
+++ b/docs/setup.md
@@@ -708,9 -713,8 +708,10 @@@ Paperless runs on Raspberry Pi. However
  the Pi and configuring some options in paperless can help improve
  performance immensely:
  
- -   Stick with SQLite to save some resources.
+ -   Stick with SQLite to save some resources. See [troubleshooting](troubleshooting.md#log-reports-creating-paperlesstask-failed)
+     if you encounter issues with SQLite locking.
 +-   If you do not need the filesystem-based consumer, consider disabling it
 +    entirely by setting [`PAPERLESS_CONSUMER_DISABLE`](configuration.md#PAPERLESS_CONSUMER_DISABLE) to `true`.
  -   Consider setting [`PAPERLESS_OCR_PAGES`](configuration.md#PAPERLESS_OCR_PAGES) to 1, so that paperless will
      only OCR the first page of your documents. In most cases, this page
      contains enough information to be able to find it.
diff --cc docs/troubleshooting.md
index bed8619876,bbb23c9598..e9eaa5692f
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@@ -292,9 -320,11 +292,11 @@@ many workers attempting to access the d
  Consider changing to the PostgreSQL database if you will be processing
  many documents at once often. Otherwise, try tweaking the
  [`PAPERLESS_DB_TIMEOUT`](configuration.md#PAPERLESS_DB_TIMEOUT) setting to allow more time for the database to
- unlock. This may have minor performance implications.
+ unlock. Additionally, you can change your SQLite database to use ["Write-Ahead Logging"](https://sqlite.org/wal.html).
+ These changes may have minor performance implications but can help
+ prevent database locking issues.
  
 -## gunicorn fails to start with "is not a valid port number"
 +## granian fails to start with "is not a valid port number"
  
  You are likely running using Kubernetes, which automatically creates an
  environment variable named `${serviceName}_PORT`. This is