# Catatan Email — geonet.co.id (Zammad SMTP)

> **Terakhir Diperbarui:** 2026-07-02  
> **Status setup wizard:** Email notification **di-skip** (POC OK). Admin: `support@geonet.co.id`.
> ⚠️ **Jangan commit password.** Simpan password hanya di password manager / input wizard Zammad.

---

## Akun yang dipakai

| Item | Nilai |
|------|-------|
| Alamat email | `support@geonet.co.id` |
| Password | *(password akun email — tidak didokumentasikan di repo)* |

---

## Pengaturan resmi geonet.co.id (Recommended — SSL/TLS)

| Arah | Server | Port | Protokol |
|------|--------|------|----------|
| **Outgoing SMTP** | `mail.geonet.co.id` | **465** | SSL/TLS (implicit) |
| Incoming IMAP | `mail.geonet.co.id` | 993 | SSL/TLS |
| Incoming POP3 | `mail.geonet.co.id` | 995 | SSL/TLS |

Alternatif SMTP (STARTTLS, tidak diprioritaskan jika 465 gagal dari server):

| Outgoing SMTP | `mail.geonet.co.id` | **587** | STARTTLS |

Semua protokol **wajib autentikasi** (username = alamat email penuh).

---

## Pengaturan alternatif (cPanel / idcloudhosting)

Beberapa client menampilkan hostname backend:

| Item | Nilai |
|------|-------|
| Incoming (POP3) | `sc138.idcloudhosting.cloud:995` SSL |
| Outgoing (SMTP) | `sc138.idcloudhosting.cloud:465` SSL |

> `sc138.idcloudhosting.cloud` dan `mail.geonet.co.id` biasanya server yang sama (CNAME/alias).  
> **Utamakan `mail.geonet.co.id`** — lebih stabil untuk konfigurasi aplikasi.

---

## Isian Zammad — Email Notification (setup wizard)

Pilih: **SMTP — configure your own outgoing SMTP setting**

### Kombinasi yang disarankan (setelah wizard)

| Field Zammad | Isi |
|--------------|-----|
| **Host** | `sc138.idcloudhosting.cloud` |
| **User** | `support@geonet.co.id` |
| **Password** | *(password akun email)* |
| **Port** | `465` |
| **SSL verification** | `yes` *(cert cocok dengan hostname `sc138`)* |
| **Sender / From** | `support@geonet.co.id` *(wajib sebelum test kirim)* |

> Jangan pakai `mail.geonet.co.id` + SSL verify **yes** — cert server untuk hostname `sc138`, bukan `mail` → hostname mismatch.

### Alternatif (kurang ideal)

| Host | Port | SSL verification |
|------|------|----------------|
| `mail.geonet.co.id` | 465 | **no** *(hanya jika cert tidak bisa diperbaiki di hosting)* |

### Jika masih timeout

Kemungkinan **firewall server `10.100.1.24`** memblokir outbound SMTP (465/587).  
Cek dari server:

```bash
nc -zv -w5 mail.geonet.co.id 465
nc -zv -w5 mail.geonet.co.id 587
```

Jika timeout dari server tapi OK dari laptop → buka outbound SMTP di firewall MikroTik / host.

**Workaround POC:** klik **Skip** di wizard — notifikasi email dikonfigurasi ulang setelah Mailcow (roadmap fase berikutnya).

---

## Roadmap email Super Apps

| Fase | Platform |
|------|----------|
| Sekarang (POC) | SMTP `support@geonet.co.id` via `mail.geonet.co.id` *(opsional)* |
| Berikutnya | **Mailcow** — Zammad channel email inbound/outbound terpusat |

---

### DNS Docker container (SMTP gagal)

Jika error `getaddrinfo` atau `SSL_read: unexpected eof` dari **dalam** Zammad padahal `nc` dari host OK — DNS container rusak.

**Fix:** `infra/zammad/docker-compose.override.yml` — tambah `dns: [203.142.82.222, 203.142.84.222]` lalu recreate container.

---

## Error yang pernah terjadi (2026-07-02)

| Error | Host | Penyebab | Solusi |
|-------|------|----------|--------|
| `port 587 timed out` | `sc138...` | Port 587 lambat/diblok | Pakai port **465** |
| `certificate verify failed (hostname mismatch)` | `mail.geonet.co.id:465` | Cert SSL untuk `sc138.idcloudhosting.cloud`, bukan `mail.geonet.co.id` | Host → `sc138...` + SSL yes, **atau** `mail...` + SSL **no** |
| `SSL_read: unexpected eof` / `getaddrinfo` | `sc138` 465/587 | DNS container Docker gagal resolve hostname | Fix DNS di `docker-compose.override.yml` — lihat `docs/issues.md` |
| `550 From domain must match authenticated domain` | `sc138...:465` | From bukan `@geonet.co.id` | Set **sender** = `support@geonet.co.id` dulu |

**Keputusan POC:** Skip email di wizard — Zammad tetap jalan tanpa notifikasi email sampai Mailcow atau SMTP diperbaiki.

### Lokasi konfigurasi ulang (setelah wizard)

**Admin → Channels → Email** — bagian Email Notification (SMTP)

URL: `https://zammad.gisportal.id/#channels/email`

Panduan lengkap step-by-step: [`smtp-notification-setup.md`](smtp-notification-setup.md)