From 34934b2da5c34ac77962d569cafee9179bea84b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jeffrey=20Bo=CC=88hm?= <hello@jeffrey-boehm.de>
Date: Thu, 22 Jan 2026 18:18:19 +0100
Subject: [PATCH] fix(compose): add data-spool volume for Postfix mail queue
 and update documentation (fixes #652)

---
 deploy/compose/mta.yaml          | 1 +
 docker-compose.yml               | 1 +
 docs/development/architecture.md | 3 +++
 3 files changed, 5 insertions(+)

diff --git a/deploy/compose/mta.yaml b/deploy/compose/mta.yaml
index bc4d98c6..2f3c296e 100644
--- a/deploy/compose/mta.yaml
+++ b/deploy/compose/mta.yaml
@@ -11,6 +11,7 @@ services:
     env_file: ../../.env
     volumes:
       - data-tls:/etc/postfix/tls:ro
+      - data-spool:/var/spool/postfix
       # For using external certificates uncomment the following lines
       # and change the path on the left side of the colon.
       # - /home/user/certs/mail.example.com.crt:/etc/postfix/tls.crt:ro
diff --git a/docker-compose.yml b/docker-compose.yml
index 4623e2ef..004c5509 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -29,3 +29,4 @@ volumes:
   data-tls:
   data-filter:
   data-redis:
+  data-spool:
diff --git a/docs/development/architecture.md b/docs/development/architecture.md
index 4708911a..f2d341ef 100644
--- a/docs/development/architecture.md
+++ b/docs/development/architecture.md
@@ -25,6 +25,7 @@ volumes:
   data-tls: # TLS certificates and keys
   data-filter: # RSpamd filter data and statistics
   data-redis: # Redis cache and session data
+  data-spool: # Postfix mail queue and spool directory
 ```
 
 ### Volume Mounts by Service
@@ -36,6 +37,7 @@ volumes:
 #### Mail Transfer Agent (`mta`)
 
 - **`data-tls:/etc/postfix/tls:ro`** - Read-only access to TLS certificates for SMTP encryption
+- **`data-spool:/var/spool/postfix`** - Postfix mail queue and spool directory for message processing
 
 #### Mail Delivery Agent (`mda`)
 
@@ -61,5 +63,6 @@ volumes:
 - **`data-tls`**: Required for maintaining SSL/TLS certificates and encryption keys
 - **`data-filter`**: Important for spam filter learning and statistics accumulation
 - **`data-redis`**: Used for session management and temporary data caching
+- **`data-spool`**: Stores Postfix mail queue and spool data, ensuring message processing continuity across restarts
 
 These volumes ensure that your mail server data survives container updates, restarts, and even complete system reboots, making the deployment production-ready and reliable.