# Troubleshooting — Zammad

> **Terakhir Diperbarui:** 2026-07-02

---

## OSS / S3

### Upload attachment gagal di Zammad

1. Cek `storage.yml` / env S3 di container Zammad
2. Verifikasi bucket dari server:

```bash
export $(grep -E "^OSS_" /opt/stacks/geonet-console/.env | xargs)
export OSS_BUCKET_TARGET=zammad-attachments
docker exec -e OSS_ACCESS_KEY_ID -e OSS_SECRET_ACCESS_KEY -e OSS_ENDPOINT -e OSS_REGION -e OSS_BUCKET_TARGET \
  geonet-console php /tmp/oss-create-bucket.php
```

3. Pastikan `force_path_style: true` dan endpoint `http://10.100.1.10:8010`

### 503 saat create bucket / upload pertama

Lihat [`issues.md`](issues.md) — retry setelah beberapa detik.

---

## Elasticsearch

### Zammad lambat atau search error

```bash
docker logs zammad-elasticsearch --tail 50
```

- Pastikan `vm.max_map_count=262144` di host (`sysctl vm.max_map_count`)
- Cek RAM tersedia (target stack ~8–12 GB dengan ES)

---

## LDAP

### User LDAP tidak bisa login

1. Test bind dari server .24 ke `10.100.1.40:389`
2. Cek Base DN: `DC=gisportal,DC=id`
3. Pastikan filter user/group di Zammad sesuai atribut AD
4. Bandingkan dengan config geonet-console (`server-connection/docs/environment.md`)

---

## Nginx

### 502 Bad Gateway

```bash
docker ps --filter name=zammad
curl -sI http://127.0.0.1:<zammad-port>/
nginx -t
```

Pastikan upstream mengarah ke container `zammad-railsserver` yang healthy.

---

## PostgreSQL eksternal

### Connection refused ke 10.100.1.25

- Cek `pg_hba.conf` mengizinkan host `10.100.1.24`
- Cek firewall internal
- Verifikasi user `zammad` dan database `zammad` ada