docs(PROJ-58): batch_mode für Neuinstallationen standardmäßig aktivieren

config.docker.yml.example setzt index.batch_mode/ocr.batch_mode jetzt
auf true statt es nur kommentiert zu zeigen, damit neue Installationen
direkt mit Cron-Batch-Verarbeitung statt Dauerbetrieb starten. Bestehende
Installationen (131/132) sind unberührt, da ihre config.yml unabhängig
vom Repo-Beispiel ist.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
sysops
2026-06-24 23:16:34 +02:00
co-authored by Claude Sonnet 4.6
parent fae274f930
commit c91eeac0a0
2 changed files with 15 additions and 8 deletions
+12 -8
View File
@@ -30,12 +30,14 @@ index:
backend: xapian backend: xapian
batch_size: 100 batch_size: 100
async_queue_size: 1000 async_queue_size: 1000
# PROJ-58: batch_mode (optional, default false). # PROJ-58: batch_mode (optional, Default false wenn weggelassen).
# true = der Dauerbetrieb-Index-Worker wird NICHT gestartet; neue Mails # true = der Dauerbetrieb-Index-Worker wird NICHT gestartet; neue Mails
# bleiben indexed_at IS NULL bis der Cron-Job 'archivmail index-pending' # bleiben indexed_at IS NULL bis der Cron-Job 'archivmail index-pending'
# sie verarbeitet (siehe deploy/cron.d/archivmail). Glättet Schreiblast. # sie verarbeitet (siehe deploy/cron.d/archivmail, Zeiten dort anpassbar).
# false (Default) = sofortige, fortlaufende Indexierung wie bisher. # Glättet Schreiblast auf der Festplatte. false = sofortige, fortlaufende
# batch_mode: false # Indexierung. Für Neuinstallationen ist batch_mode hier standardmäßig
# aktiviert — bei Bedarf einfach auf false setzen.
batch_mode: true
api: api:
bind: "0.0.0.0:8080" bind: "0.0.0.0:8080"
@@ -68,13 +70,15 @@ imap_server:
# ocr: # ocr:
# paused_hours: [8, 18] # OCR pausiert während der Geschäftszeiten # paused_hours: [8, 18] # OCR pausiert während der Geschäftszeiten
# #
# PROJ-58: ocr.batch_mode (optional, default false). # PROJ-58: ocr.batch_mode (optional, Default false wenn weggelassen).
# true = der Dauerbetrieb-OCR-Worker wird NICHT gestartet; neue Mails bleiben # true = der Dauerbetrieb-OCR-Worker wird NICHT gestartet; neue Mails bleiben
# ocr_status='pending' bis der Cron-Job # ocr_status='pending' bis der Cron-Job
# 'archivmail ocr-reprocess --status pending' sie verarbeitet # 'archivmail ocr-reprocess --status pending' sie verarbeitet
# (siehe deploy/cron.d/archivmail). false (Default) = sofortige Verarbeitung. # (siehe deploy/cron.d/archivmail, Zeiten dort anpassbar). false = sofortige
# ocr: # Verarbeitung. Für Neuinstallationen ist batch_mode hier standardmäßig
# batch_mode: false # aktiviert — bei Bedarf einfach auf false setzen.
ocr:
batch_mode: true
# PROJ-56: IMAP-Sync-Jitter (optional). # PROJ-56: IMAP-Sync-Jitter (optional).
# jitter_seconds verteilt den tatsächlichen Sync-Start jedes Accounts # jitter_seconds verteilt den tatsächlichen Sync-Start jedes Accounts
+3
View File
@@ -59,6 +59,9 @@ Aktuell laufen Indexierung (`internal/index/tenant_worker.go`) und OCR (`interna
- Minor-Finding behoben: `index-pending` fehlte in `printHelp()` (cmd_import.go) — ergänzt. - Minor-Finding behoben: `index-pending` fehlte in `printHelp()` (cmd_import.go) — ergänzt.
- Keine Critical/High-Findings. Server 192.168.1.131 nicht angefasst während der QA. - Keine Critical/High-Findings. Server 192.168.1.131 nicht angefasst während der QA.
## Nachtrag (2026-06-24): batch_mode als Default für Neuinstallationen
Auf Nutzerwunsch ist `index.batch_mode: true` und `ocr.batch_mode: true` jetzt aktiv (nicht mehr auskommentiert) in `config/config.docker.yml.example` gesetzt, damit neue Installationen direkt mit Cron-Batch statt Dauerbetrieb starten. Bestehende Installationen (wie 192.168.1.131/132) sind davon nicht betroffen, da deren `/etc/archivmail/config.yml` unabhängig vom Repo-Beispiel ist und weiterhin ohne `batch_mode`-Einträge (= Dauerbetrieb) läuft.
## Out of Scope ## Out of Scope
- Kein Wechsel der bestehenden Mechanismen für Installationen, die `batch_mode` nicht setzen. - Kein Wechsel der bestehenden Mechanismen für Installationen, die `batch_mode` nicht setzen.
- Kein UI/Admin-Schalter im Frontend — Konfiguration ausschließlich über `config.yml` + `cron.d`. - Kein UI/Admin-Schalter im Frontend — Konfiguration ausschließlich über `config.yml` + `cron.d`.