# System Requirements — Mailcow

**Owner:** runtime minimum agar Mailcow + fetchmail berjalan.
Inventori host: [server.md](./server.md). Env: [.env.example](../.env.example).

---

## Ringkasan

| Field | Value |
|-------|-------|
| Project | `Mailcow/` |
| Tipe | infra (mail server) |
| Last updated | 2026-07-06 |

---

## Platform & OS

| Komponen | Minimum | Dipakai saat ini |
|----------|---------|------------------|
| OS server | Ubuntu 22.04 LTS | Ubuntu 22.04.5 LTS |
| Arsitektur | x64 | x64 |
| `vm.max_map_count` | 262144 | 262144 |

---

## Runtime & Toolchain

| Tool | Minimum | Dipakai | Cek |
|------|---------|---------|-----|
| Docker | 24+ | 29.x | `docker --version` |
| Docker Compose | v2 | v5 | `docker compose version` |
| fetchmail | 6.x | systemd package | `fetchmail -V` |
| systemd | — | timer 2 menit | `systemctl status fetchmail-support.timer` |

---

## Resource minimum (VM Mailcow)

| Lingkungan | CPU | RAM | Disk |
|------------|-----|-----|------|
| prod (30+ user) | 8 vCPU | 16 GiB | 2×256 GiB SSD |
| prod (saat ini) | **16 vCPU** | **32 GiB** | 2×512 GiB SSD |

Disk 2: `/data/mailcow/vmail` (Dovecot mail storage live).

---

## Dependency eksternal

| Dependency | Host | Dipakai untuk |
|------------|------|---------------|
| nginx reverse proxy | `10.100.1.24` | HTTPS UI `sync.geonet.co.id` |
| Active Directory LDAP | `10.100.1.40:389` | Identity Provider (bukan `support@`) |
| cPanel POP3 | `mail.geonet.co.id:995` | fetchmail drain (transisi) |
| cPanel SMTP relay | `sc138.idcloudhosting.cloud:587` | Outbound transisi |
| QNAP NAS | `10.100.1.10` | Backup harian |
| Dockge primary | `10.100.1.24` | Manajemen stack |

---

## Variabel URL & konfigurasi (no hardcode)

| Variabel | Wajib | Contoh | Dipakai oleh |
|----------|-------|--------|--------------|
| `MAILCOW_HOSTNAME` | ya | `sync.geonet.co.id` | Mailcow generate_config |
| `MAILCOW_VM_IP` | ya | `10.100.1.28` | docs, SSH |
| `MAILCOW_SUPPORT_EMAIL` | ya | `support@geonet.co.id` | fetchmail, Zammad |
| `MAILCOW_SUPPORT_PASSWORD` | ya | *(secret)* | fetchmail, SOGo, SMTP |
| `LDAP_HOST` | opsional | `10.100.1.40` | Identity Provider |
| `LEGACY_SMTP_HOST` | transisi | `sc138.idcloudhosting.cloud` | relay outbound |

Detail: [environment.md](./environment.md), [.env.example](../.env.example).

---

## Port & protokol

| Service | Port | Protokol |
|---------|------|----------|
| SMTP inbound | 25 | TCP |
| SMTPS | 465 | TCP/TLS |
| Submission | 587 | TCP/STARTTLS |
| IMAPS | 993 | TCP/TLS |
| POP3S | 995 | TCP/TLS |
| HTTPS (UI) | 443 | HTTPS |
| Dockge agent | 5001 | HTTP (LAN only) |

---

## Client IMAP (PC user)

| Setting | Nilai |
|---------|-------|
| Server | `sync.geonet.co.id` |
| Port | 993 SSL/TLS |
| Username | `support@geonet.co.id` |
| Password | Password Mailcow (bukan AD) |

Panduan lengkap: [guide/outlook-imap-setup.md](./guide/outlook-imap-setup.md).