# Storage Email — NAS QNAP

> **Terakhir Diperbarui:** 2026-07-03  
> **NAS:** QNAP `10.100.1.10`  
> **Keputusan (2026-07-03):** ✅ **Local SSD VM** untuk live vmail — prioritas **uptime layanan mail**. QNAP hanya untuk **backup**, bukan iSCSI/NFS live.

---

## Jawaban singkat

**Ya, bisa** — tapi hanya untuk **filesystem Maildir** (`vmail`), **bukan** lewat Object Storage (S3/OSS) seperti attachment Zammad.

| Metode | Live mailbox di NAS | Rekomendasi |
|--------|---------------------|-------------|
| **iSCSI** (LUN QNAP → VM) | ✅ | 🥇 **Paling proper** — seperti disk lokal |
| **NFS** v4 + bind mount | ✅ | 🥈 Bisa, perlu tuning Dovecot |
| **Backup/rsync** ke NAS | Hanya salinan | 🥇 **Wajib** — kombinasi dengan disk lokal |
| **SMB/CIFS** mount langsung | ⚠️ | Hindari untuk Maildir aktif |
| **QNAP OSS / S3** | ❌ | Mailcow tidak support object storage untuk vmail |

---

## Apa yang disimpan di NAS vs tetap lokal VM

| Data | NAS live? | Catatan |
|------|-----------|---------|
| `vmail` (email Maildir) | ✅ Bisa | Target utama pindah storage |
| `vmail-attachments` | ✅ Bisa | Attachment besar |
| **MariaDB** (database Mailcow) | ❌ **Jangan** | NFS + MySQL = corrupt risk |
| **Redis** | ❌ **Jangan** | Tetap disk lokal VM |
| Index Dovecot | ⚠️ | Bisa di NAS jika vmail di NAS + `mail_nfs_*` |

**Aturan:** Hanya **file email** ke NAS; database & cache tetap di VM.

---

## Perbandingan: iSCSI QNAP vs Local Storage VM

> Konteks: VM Mailcow di Proxmox `.102`, NAS QNAP `.10`, ~30 user IMAP aktif, Maildir (banyak file kecil).

### Kecepatan

| Aspek | **Local storage VM** | **iSCSI LUN QNAP** |
|-------|----------------------|---------------------|
| Latency per operasi file | **~0,1–0,5 ms** (VirtIO SSD) | **~1–3 ms** (LAN + iSCSI stack) |
| Throughput maksimum | Sesuai disk host (SSD: 500+ MB/s) | **~110 MB/s** (1 GbE) · ~1 GB/s (10 GbE) |
| IMAP / Outlook sync (banyak file kecil) | **Lebih responsif** | Cukup, terasa sedikit lebih lambat saat sync awal |
| Beban 30 user concurrent | **Lebih nyaman** | Bisa, bottleneck di jaringan 1 GbE |
| Postfix queue / spike | **Lebih stabil** | Lonjakan I/O + traffic LAN bersamaan |

**Pola beban Mailcow:** Dovecot membaca/ menulis ribuan file kecil (Maildir) — **sangat sensitif latency**, bukan hanya throughput. Local SSD menang jelas untuk kecepatan sehari-hari.

### Keandalan

| Aspek | **Local storage VM** | **iSCSI LUN QNAP** |
|-------|----------------------|---------------------|
| Kegagalan disk VM saja | ❌ Data ikut hilang *(tanpa backup)* | ✅ Data tetap di QNAP RAID |
| Kegagalan NAS / jaringan | ✅ VM tetap jalan *(jika disk lokal)* | ❌ **Mail down** — I/O hang |
| Reboot VM | ✅ Stabil | ⚠️ Perlu iSCSI reconnect otomatis |
| RAID / redundansi | Tergantung disk Proxmox host | ✅ QNAP RAID5/6 biasanya lebih baik |
| Restore disaster | Dari backup QNAP | LUN snapshot / replicate NAS |
| Single point of failure | Disk VM (tipis) | **NAS + switch + kabel LAN** |

**Keandalan data mentah:** iSCSI ke QNAP RAID lebih aman jika disk Proxmox `.102` tidak RAID.  
**Keandalan layanan mail online:** local storage lebih andal — tidak bergantung jaringan ke NAS.

### Skor ringkas (30 user produksi)

| Kriteria | Local VM (SSD) | iSCSI QNAP |
|----------|----------------|------------|
| **Kecepatan** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| **Uptime layanan** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| **Keamanan data (hardware)** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Kapasitas / expand** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Kesederhanaan ops** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |

---

## Rekomendasi terbaik (Geonet)

### 🥇 **Hybrid — dipilih Geonet (2026-07-03)**

Prioritas: **uptime layanan mail** → live storage **local SSD VM**, bukan NAS.

```
Live vmail  →  Local SSD VM `10.100.1.28` disk 2 (512 GiB)
Backup      →  QNAP harian (rsync / Mailcow backup)
DB + Redis  →  Local SSD VM (selalu)
```

| Mengapa | |
|---------|--|
| Kecepatan IMAP/Outlook | Maksimal — tanpa hop jaringan |
| **Uptime mail** | Mail tetap jalan meski NAS maintenance / LAN ke QNAP down |
| Keandalan data | Backup harian + snapshot QNAP |
| Kompleksitas | Rendah — tidak perlu iSCSI tuning |

### 🥈 **iSCSI QNAP** — tidak dipilih *(trade-off uptime)*

- Disk lokal Proxmox `.102` **kecil atau HDD lambat**
- QNAP punya **SSD pool** dan kapasitas besar
- Ingin **satu pool storage terpusat** + snapshot LUN
- Bisa terima trade-off: sedikit lebih lambat, risiko mail down saat NAS/LAN bermasalah

### ❌ Hindari:

- NFS/SMB live untuk vmail (lebih lemah dari iSCSI untuk Maildir)
- Hanya local tanpa backup ke QNAP
- Hanya iSCSI tanpa monitoring path NAS

---

QNAP expose LUN iSCSI → Proxmox/VM mount sebagai block device.

```
QNAP 10.100.1.10
  └── iSCSI LUN 300GB "mailcow-vmail"
        └── VM mail-sync (Debian)
              └── /dev/sdb → ext4 → /data/mailcow/vmail
                    └── docker-compose.override.yml bind mount
```

**Kelebihan:**
- Performa mendekati disk lokal
- Tidak ada masalah file locking seperti NFS
- Dovecot tidak perlu mode NFS khusus
- Expand LUN dari QNAP saat penuh

**Setup ringkas:**
1. QNAP → iSCSI Storage → buat LUN + target
2. VM → `iscsiadm` connect → format `ext4` → `/etc/fstab`
3. Mailcow `docker-compose.override.yml` bind ke path tersebut

---

## Opsi 2 — NFS (bisa, butuh hati-hati)

Mount NFS di host VM, bind ke volume Docker — **jangan pakai symlink** ke `_data` Docker (risiko inbox kosong setelah reboot).

### Host: `/etc/fstab`

```
10.100.1.10:/mailcow-vmail  /mnt/mailcow-vmail  nfs  nfsvers=4.1,noac,rw,hard,timeo=600,retrans=2,_netdev  0  0
```

> `noac` = disable attribute cache — penting untuk konsistensi Maildir di NFS.

### Mailcow: `docker-compose.override.yml`

```yaml
volumes:
  vmail-vol-1:
    driver: local
    driver_opts:
      type: none
      device: /mnt/mailcow-vmail
      o: bind
```

### Dovecot: aktifkan mode NFS

Edit `data/conf/dovecot/dovecot.conf` (uncomment):

```
mmap_disable = yes
mail_fsync = always
mail_nfs_index = yes
mail_nfs_storage = yes
```

Restart: `docker compose restart dovecot-mailcow`

**Risiko NFS:** permission intermittent, latency IMAP, issue saat reboot jika mount order salah.

Ref: [Mailcow — Move Maildir](https://docs.mailcow.email/manual-guides/Dovecot/u_e-dovecot-vmail-volume/), [GitHub #5339](https://github.com/mailcow/mailcow-dockerized/issues/5339)

---

## Opsi 3 — Disk lokal VM + backup ke NAS (paling sederhana)

| Live | Backup |
|------|--------|
| Disk VM 512 GiB vmail (`.27`) | Harian rsync/NFS ke QNAP |

```
/opt/stacks/mailcow/helper-scripts/backup_and_restore.sh backup all
# → rsync ke 10.100.1.10:/backup/mailcow/
```

**Kelebihan:** Stabil, tidak ada kompleksitas NFS/iSCSI.  
**Kekurangan:** Kapasitas terbatas ukuran disk VM — expand manual.

Cocok jika awal 30 user dan belum butuh ratusan GB segera.

---

## Perbandingan untuk 30+ user aktif

| Kriteria | iSCSI | NFS live | Lokal + backup NAS |
|----------|-------|----------|---------------------|
| Stabilitas IMAP | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Expand storage | Mudah (grow LUN) | Mudah | Expand disk VM |
| Kompleksitas | Sedang | Tinggi | Rendah |
| Performa Outlook sync | Baik | Sedang | Baik |
| Disaster recovery | Snapshot LUN QNAP | Snapshot share | Restore dari backup |

**Rekomendasi Geonet:** **iSCSI LUN dari QNAP** untuk vmail live + **backup harian** script Mailcow ke share NFS terpisah.

---

## QNAP — share yang disarankan

| Share QNAP | Protokol | Fungsi |
|------------|----------|--------|
| `mailcow-vmail` | iSCSI LUN atau NFS | Data email live |
| `backup-mailcow` | NFS / SMB | Backup harian (rsync) |

Jaringan: VM `.102` ↔ NAS `.10` lewat LAN `10.100.1.x` (low latency).

---

## Yang tidak bisa: OSS seperti Zammad

Zammad attachment pakai **S3** (`http://10.100.1.10:8010`). Mailcow **tidak** punya driver S3 untuk mailbox — Dovecot butuh **Maildir di filesystem POSIX**.

---

## Checklist implementasi NAS

- [ ] Pilih: iSCSI (preferred) atau NFS atau lokal+backup
- [ ] Buat LUN/share di QNAP
- [ ] Mount di VM **sebelum** Docker start (`_netdev` di fstab)
- [ ] `docker-compose.override.yml` bind mount (bukan symlink)
- [ ] Dovecot NFS settings jika pakai NFS
- [ ] MariaDB/Redis tetap volume lokal
- [ ] Tes reboot VM — inbox tidak boleh kosong
- [ ] Backup harian ke share terpisah

---

## Referensi

- `docs/notes/deployment-sizing.md`
- [Mailcow vmail volume](https://docs.mailcow.email/manual-guides/Dovecot/u_e-dovecot-vmail-volume/)
- QNAP iSCSI: Storage & Snapshots → iSCSI