# Migration Guide — Ollama VM

**Owner:** prosedur pindah Ollama ke host/IP baru.
Inventori: [../server.md](../server.md). Env: [../../.env.example](../../.env.example).

**Prinsip:** ubah `OLLAMA_BASE_URL` di consumer — bukan hardcode di kode.

---

## Inventori sebelum migrasi

| Item | Nilai saat ini | File yang diupdate |
|------|----------------|-------------------|
| Ollama host | `10.100.1.26` (`aiopr`) | `Ollama/docs/server.md`, `.env.example` |
| API URL | `http://10.100.1.26:11434` | geonet-console `.env` di `.24` |
| Model path | `/data/ollama/models` | systemd override |
| UFW | `11434` dari `10.100.1.0/24` | server UFW rules |

---

## Variabel env terpengaruh

| Variabel | Old | New | Lokasi |
|----------|-----|-----|--------|
| `OLLAMA_BASE_URL` | `http://10.100.1.26:11434` | `{new}` | geonet-console `.env` |
| `OLLAMA_HOST` | `0.0.0.0:11434` | (sama) | systemd `.26` |

---

## Langkah migrasi VM

1. **Persiapan VM baru**
   - [ ] Ubuntu 22.04 Server, vCPU ≥ 16, RAM ≥ 32 GiB
   - [ ] Install Ollama + buat `/data/ollama/models`
   - [ ] UFW: 22 + 11434 dari VLAN saja

2. **Salin model** (pilih salah satu)
   - [ ] `rsync -av /data/ollama/models/` ke VM baru, atau
   - [ ] `ollama pull` ulang di VM baru

3. **Parallel test**
   - [ ] `curl` `/api/version` dari `.24`
   - [ ] Chat + embed smoke test

4. **Cutover consumer**
   - [ ] Update `OLLAMA_BASE_URL` di geonet-console `.env`
   - [ ] Restart container geonet-console

5. **Dokumentasi**
   - [ ] Update `Ollama/docs/server.md`, `Workspace-Context.md`
   - [ ] Append `version.md` + `changelog.md`

---

## Rollback

1. Kembalikan `OLLAMA_BASE_URL` ke IP lama
2. Restart consumer
3. Catat di `issues.md`

---

## Riwayat migrasi

| Tanggal | Dari | Ke | Catatan |
|---------|------|-----|---------|
| — | — | — | Belum ada migrasi |