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
batch_size: 100
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
# bleiben indexed_at IS NULL bis der Cron-Job 'archivmail index-pending'
# sie verarbeitet (siehe deploy/cron.d/archivmail). Glättet Schreiblast.
# false (Default) = sofortige, fortlaufende Indexierung wie bisher.
# batch_mode: false
# sie verarbeitet (siehe deploy/cron.d/archivmail, Zeiten dort anpassbar).
# Glättet Schreiblast auf der Festplatte. false = sofortige, fortlaufende
# Indexierung. Für Neuinstallationen ist batch_mode hier standardmäßig
# aktiviert — bei Bedarf einfach auf false setzen.
batch_mode: true
api:
bind: "0.0.0.0:8080"
@@ -68,13 +70,15 @@ imap_server:
# ocr:
# 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
# ocr_status='pending' bis der Cron-Job
# 'archivmail ocr-reprocess --status pending' sie verarbeitet
# (siehe deploy/cron.d/archivmail). false (Default) = sofortige Verarbeitung.
# ocr:
# batch_mode: false
# (siehe deploy/cron.d/archivmail, Zeiten dort anpassbar). false = sofortige
# Verarbeitung. Für Neuinstallationen ist batch_mode hier standardmäßig
# aktiviert — bei Bedarf einfach auf false setzen.
ocr:
batch_mode: true
# PROJ-56: IMAP-Sync-Jitter (optional).
# 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.
- 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
- 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`.