From 25e33caec96022de247bce16ae0c63cef374da7a Mon Sep 17 00:00:00 2001
From: il <il@ilnmors.internal>
Date: Wed, 25 Mar 2026 23:47:50 +0900
Subject: [PATCH] roles, config, docs: update set_paperless.yaml,
 paperless.container.j2, paperless-ngx.md to add redis_paperless container
 restart logic and to optimize paperless-ngx configuration

---
 ansible/roles/app/tasks/services/set_paperless.yaml    |  5 +++--
 .../containers/app/paperless/paperless.container.j2    |  4 +++-
 docs/services/app/paperless-ngx.md                     | 10 ++++++++++
 3 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/ansible/roles/app/tasks/services/set_paperless.yaml b/ansible/roles/app/tasks/services/set_paperless.yaml
index 4c32bb7..a55984f 100644
--- a/ansible/roles/app/tasks/services/set_paperless.yaml
+++ b/ansible/roles/app/tasks/services/set_paperless.yaml
@@ -24,6 +24,7 @@
     owner: "{{ ansible_user }}"
     group: "svadmins"
     mode: "0644"
+  register: "is_redis_conf"
 
 - name: Deploy redis container file
   ansible.builtin.template:
@@ -32,7 +33,7 @@
     owner: "{{ ansible_user }}"
     group: "svadmins"
     mode: "0644"
-  register: "is_redis_conf"
+  register: "is_redis_containerfile"
 
 - name: Enable (Restart) redis service
   ansible.builtin.systemd:
@@ -41,7 +42,7 @@
     enabled: true
     daemon_reload: true
     scope: "user"
-  when: is_redis_conf.changed # noqa: no-handler
+  when: is_redis_conf.changed or is_redis_containerfile.changed # noqa: no-handler
 
 - name: Set paperless subuid
   ansible.builtin.set_fact:
diff --git a/config/services/containers/app/paperless/paperless.container.j2 b/config/services/containers/app/paperless/paperless.container.j2
index 0bb79a8..caab4ec 100644
--- a/config/services/containers/app/paperless/paperless.container.j2
+++ b/config/services/containers/app/paperless/paperless.container.j2
@@ -21,12 +21,14 @@ Volume=%h/containers/paperless/ssl:/etc/ssl/paperless:ro
 
 # General
 Environment="TZ=Asia/Seoul"
+Environment="PAPERLESS_TIME_ZONE=Asia/Seoul"
 Environment="PAPERLESS_URL=https://paperless.ilnmors.com"
 Environment="PAPERLESS_OCR_LANGUAGE=kor+eng"
 Environment="PAPERLESS_OCR_LANGUAGES=kor"
-Environment="PAPERLESS_OCR_MODE=force"
+# Environment="PAPERLESS_OCR_MODE=force"
 # Environment="PAPERLESS_TASK_WORKERS=1"
 # Environment="PAPERLESS_THREADS_PER_WORKER=1"
+Environment="PAPERLESS_WORKER_TIMEOUT=7200"
 Secret=PAPERLESS_SECRET_KEY,type=env
 
 # Redis
diff --git a/docs/services/app/paperless-ngx.md b/docs/services/app/paperless-ngx.md
index c46d48b..ac62154 100644
--- a/docs/services/app/paperless-ngx.md
+++ b/docs/services/app/paperless-ngx.md
@@ -60,6 +60,16 @@ ALTER DATABASE paperless_db OWNER TO paperless;
   - Continue
   - Login with Authelia
 
+### OCR configuration
+
+- Configuration: OCR settings
+  - Output Type: pdfa
+  - Mode: skip
+    - When the archive file has broken ocr text, then conduct replcae command manually
+  - Skip archive File: never
+  - Deskew: disable \(toggle to enable and once more to active disable option\)
+  - rotate: disable \(toggle to enable and once more to active disable option\)
+
 ## The non-standard pdf file
 
 - Some pdf files doesn't follow the standard, for example korean court or government pdf files.