Docker Compose v2

A. Ringkasan & Definition of Done

Panduan ini menjalankan AlurKerja on-premises di mesin lokal menggunakan alurkerja-cli — CLI untuk operasional AlurKerja dengan command utama build-alurkerja. Command ini berjalan dua fase: Setup (5 step tetap, +1 khusus Windows) lalu Install yang dirakit sesuai konfigurasi — step yang tidak relevan (mis. Start postgres saat memakai database eksternal) tidak muncul sama sekali. Pipeline idempoten: step yang sudah selesai otomatis di-SKIP, jadi kalau gagal di tengah cukup jalankan ulang setelah masalahnya diatasi — tidak ada yang dikerjakan dua kali.

Definition of Done (DoD) — instalasi dianggap selesai bila:

• Pipeline build-alurkerja selesai sampai step Summary dan menampilkan daftar URL akses.
• Semua container dalam state running (docker compose ps tanpa Exited/Restarting).
• Aplikasi dapat diakses di https://alurkerja.local:8100 dan Keycloak di https://alurkerja.local:8100/sso (skema domain lokal bawaan — lihat Section J).

Estimasi waktu eksekusi: ±20 menit untuk build pertama, paling lama di pull image (tergantung kecepatan internet). CLI menampilkan estimasi total di awal, estimasi per step di header-nya, dan durasi aktual tiap step selesai.

B. Prasyarat

Langkah 1–4 memastikan environment siap. Hentikan dan perbaiki bila ada langkah yang gagal — jangan lanjut sebelum prasyarat terpenuhi.

1. Verifikasi Docker Desktop berjalan

Aksi

docker version --format '{{.Server.Version}}'
docker compose version

Expected output

Versi Docker Engine dan Docker Compose version v2.x tampil tanpa error.

Jika gagal: pastikan Docker Desktop sudah terinstall dan dalam keadaan berjalan (ikon whale aktif). Di Linux, Docker Engine + plugin docker-compose-plugin juga bisa dipakai. Pipeline membutuhkan docker compose (V2, plugin) — bawaan Docker Desktop terbaru.

2. Verifikasi Git terpasang — opsional

Aksi

git --version

Expected output

git version 2.x.x atau lebih baru.

Perhatian: pipeline instalasi tidak membutuhkan git — code diunduh sebagai zip dan CLI hanya memeriksa docker beserta plugin compose. Git tetap berguna untuk command lain (mis. alurkerja deployment init, yang meng-clone template deployment), jadi langkah ini aman dilewati kalau tujuannya hanya instalasi.

Jika gagal: install Git dari git-scm.com (Windows) atau xcode-select --install / Homebrew (macOS).

3. Verifikasi akun Harbor

Aksi

Pastikan kamu punya username + password Harbor yang valid (dipakai CLI untuk docker login dan pull image).

Expected output

Credential Harbor tersedia.

Jika gagal: minta credential Harbor ke tim Javan — registry image AlurKerja terpusat di harbor.merapi.javan.id.

4. Verifikasi free storage minimal 8 GB

Aksi

Pastikan drive tempat folder download punya minimal 8 GB free — image docker ±5 GB (29 image: postgres, keycloak, nginx, minio, mailpit, service AlurKerja, dll.) + ruang ekstrak saat pull + volume + code.

Get-PSDrive C   # lihat kolom Free — sesuaikan huruf drive tujuan

df -h ~   # lihat kolom Avail

Expected output

Free space drive tujuan minimal 8 GB.

Perhatian: CLI juga menampilkan kebutuhan ini di awal dan memberi warning kalau drive folder download kurang dari 8 GB.

C. Instalasi & Jalankan CLI

Langkah 5 punya dua cabang — pilih salah satu: 5.1 instalasi cepat (otomatis) atau 5.2 download manual. Keduanya berakhir sama: CLI terpasang dan pipeline build-alurkerja berjalan.

Perhatian: pipeline idempoten — aman dijalankan ulang kapan pun. Step yang sudah selesai ditandai SKIP.

5.1. Instalasi cepat (otomatis)

Aksi

Jalankan installer satu baris sesuai OS. Installer mendeteksi OS & arsitektur, mengunduh binary yang cocok, memasangnya ke PATH sebagai alurkerja, lalu langsung menjalankan build-alurkerja — tidak perlu Step 5.2, langsung lanjut ke Step 6:

irm https://cli.alurkerja.com/install.ps1 | iex

curl -fsSL https://cli.alurkerja.com/install.sh | bash

Expected output

Baris Platform & Install Dir tampil, checksum binary diverifikasi (Checksum verified.), lalu Installed: <path> — CLI mendarat di ~/.alurkerja/bin (Windows: %USERPROFILE%\.alurkerja\bin) dan pipeline build-alurkerja langsung berjalan.

Perhatian: installer menolak melanjutkan kalau checksum tidak bisa diambil atau tidak cocok — binary yang belum terverifikasi tidak pernah mendarat di PATH. Binary alurkerja lain yang sudah ada di PATH (mis. shim npm atau CLI generasi lama) dihapus supaya tidak menutupi yang baru.

Perhatian: perlu menjalankan ulang nanti? CLI sudah terpasang di PATH — cukup jalankan alurkerja build-alurkerja. Pipeline idempoten — aman dijalankan ulang kapan pun; step yang sudah selesai ditandai SKIP. Untuk naik ke versi CLI terbaru, jalankan lagi one-liner di atas: installer membandingkan checksum dan melewati download kalau binary sudah paling baru.

5.2. Download manual & jalankan binary

Aksi

Alternatif bila tidak memakai instalasi cepat (Step 5.1). Klik binary sesuai OS — semuanya dari distribusi resmi CLI:

Windows 32-bit tidak lagi didukung. Checksum resminya ada di checksums.txt — cocokkan sebelum menjalankan binary, karena jalur manual ini tidak memverifikasinya untuk kamu:

(Get-FileHash -Algorithm SHA256 .\alurkerja-windows-amd64.exe).Hash.ToLower()

sha256sum ./alurkerja-linux-amd64      # macOS: shasum -a 256 ./alurkerja-darwin-arm64

Bandingkan hasilnya dengan baris file yang bersangkutan di checksums.txt; kalau berbeda, jangan dijalankan — download ulang.

Di macOS/Linux, beri permission executable (dan lepas quarantine di macOS):

chmod +x ./alurkerja-darwin-arm64
xattr -d com.apple.quarantine ./alurkerja-darwin-arm64   # macOS saja

Lalu jalankan command build-alurkerja dari binary yang di-download:

.\alurkerja-windows-amd64.exe build-alurkerja

./alurkerja-darwin-arm64 build-alurkerja

Expected output

File binary ter-download, lalu pipeline mulai berjalan dan menampilkan fase Setup.

D. Eksekusi Pipeline build-alurkerja

6. Isi input yang diminta

Aksi

Semua kredensial bisa lewat prompt interaktif (password tersembunyi) atau flag. Input utama:

Lalu di Setup features (Setup step 3) muncul satu layar toggle untuk 5 resource: panah atas/bawah pindah baris, enter/spasi mengganti local↔external, enter di Continue melanjutkan (terminal non-interaktif: menu bernomor per fitur). Default semua local (container bawaan) — untuk instalasi standar cukup langsung Continue. Resource yang di-set external ditanya detail koneksinya (langsung dites, fail-fast) dan container bawaannya tidak dijalankan:

Di akhir wizard ada pertanyaan Application secrets: generate otomatis (default) atau masukkan 4 secret existing — --tenant-encryption-key, --tenant-encryption-iv, --jwt-secret, --jwt-refresh-secret (base64, input tersembunyi). Wajib memakai secret yang sama saat memakai database bekas instalasi sebelumnya, karena data terenkripsi butuh kunci yang sama. All-or-nothing: isi keempatnya atau tidak sama sekali (parsial = error).

Referensi lengkap semua variabel .env — termasuk mana yang di-generate otomatis oleh installer dan mana yang diisi user — ada di Section H.

Expected output

Semua prompt terisi dan layar fitur dikonfirmasi — pipeline lanjut ke fase Install dengan estimasi total dan daftar step hasil rakitan.

Perhatian: fitur yang sudah ditentukan lewat flag tidak muncul lagi di layar toggle. Pada instalasi existing (.env sudah ada), CLI menawarkan tiga pilihan: Do nothing (konfigurasi saat ini dipertahankan), Reconfigure features, atau Update the public domain — yang terakhir keluar dari pipeline install dan menjalankan jalur ganti domain (Section J). Kembali ke mode local kapan pun — nilai .env terkait dikembalikan ke bawaan lokal otomatis. Detail lengkap tiap mode external (nilai .env yang ditulis, perilaku container) ada di README repo alurkerja-cli.

7. Pantau pipeline sampai selesai

Aksi

Biarkan pipeline berjalan. Fase Setup 5 step — 6 di Windows. Semua interaksi dengan user (prompt, wizard, dialog UAC) sengaja dikumpulkan di fase ini supaya fase Install bisa berjalan tanpa ditunggui:

Fase Install dirakit dari hasil Setup — jumlah step menyesuaikan konfigurasi:

Alur untuk mode default (semua resource local):

Expected output

Step Summary tampil dengan daftar URL akses.

Jika gagal: baca pesan errornya, perbaiki penyebabnya (mis. Docker belum jalan), lalu jalankan ulang command yang sama — step yang sudah beres di-SKIP. Lihat juga Section F.

E. Verifikasi & Akses Pertama Kali

8. Validasi semua container running

Aksi

Dari folder download (lihat lokasi yang dipilih di Step 6):

docker compose ps

Expected output

Semua container berstatus running/healthy — tidak ada Exited atau Restarting.

Jika gagal: kalau ada container yang crash loop, cek log: docker compose logs --tail=50 <service>.

9. Akses aplikasi

Aksi

Buka URL berikut di browser (sesuai output Summary). Port diambil dari .env: AK_PORT_NGINX untuk semua URL web (default 8100) dan AK_PORT_POSTGRES untuk database (default 8101) — resource yang di-set eksternal tampil dengan alamat eksternalnya.

Instalasi bawaan memakai domain lokal + HTTPS: CLI mendaftarkan ketiga domain ke hosts file dan menerbitkan sertifikat mkcert, jadi semua URL memakai https dan modul-modul utama berbagi satu domain sebagai subpath.

Kredensial di atas adalah default .env.example — sengaja seragam (JelasAlurnya) supaya instalasi lokal gampang. Begitu instance-nya bisa dijangkau orang lain, ganti dulu di .env (POSTGRES_PASSWORD, KEYCLOAK_ADMIN_PASSWORD, MINIO_SECRET_KEY, CAMUNDA_PASSWORD) sebelum dipakai.

Nilai domain dibaca dari .env (NGINX_DOMAIN, MICROSITE_DOMAIN, MINIO_DOMAIN) — kalau diubah, seluruh URL di atas ikut. Keycloak tidak punya host sendiri: ia subroute /sso di domain utama (SSO_DOMAIN=${NGINX_DOMAIN}${PUBLIC_PORT_SUFFIX}/sso).

Expected output

Halaman App ter-render di https://alurkerja.local:8100 tanpa peringatan sertifikat (root CA mkcert sudah dipercaya) dan admin console Keycloak terbuka di https://alurkerja.local:8100/sso.

Perhatian: mau memakai domain sendiri (mis. alurkerja.dev) alih-alih domain lokal? Prosedur dan peta URL-nya ada di Section J.

Perhatian: operasi setelah instalasi — menghidupkan/mematikan stack, mengosongkan data, sampai menghapus tuntas service dan CLI — ada di Section I. Lifecycle Service.

F. Troubleshooting

• Gagal di tengah? Baca pesan errornya, perbaiki penyebabnya (mis. Docker belum jalan), lalu jalankan ulang — step yang sudah beres di-SKIP.
• Port bentrok? Step Cek port bentrok menyebutkan pemegang portnya. Stack AlurKerja lama dengan nama berbeda: matikan dengan docker compose -p <nama-project> down; proses non-Docker: tutup aplikasinya dulu.
• Proses terputus saat init database? Cukup jalankan ulang — step Load public & camunda schema selalu diulang dan idempoten. Kasus sangat jarang: init_db terputus tepat setelah membuat keycloak_db tapi sebelum schema camunda dibuat → drop database keycloak_db lalu jalankan ulang.
• Error $'\r': command not found saat setup Keycloak: folder download warisan lama masih ber-CRLF. Hapus folder itu lalu jalankan ulang — download baru selalu LF.

Lihat juga Handbook Troubleshooting untuk daftar lebih luas.

G. Logbook Instalasi

Template berikut sinkron 1:1 dengan nomor langkah di halaman ini.

H. Variabel Environment

Referensi status semua variabel .env (file tunggal di root folder download). Status ditentukan bukan sekadar "ada isinya di .env" — tapi dari nalar: apakah service benar-benar berhenti/rusak tanpanya, atau tetap jalan dengan fallback/fitur nonaktif. Variabel alias (mis. DB_USER=${POSTGRES_USER}) mengikuti status sumbernya dan ditandai (alias, otomatis) — tidak perlu diisi manual terpisah.

• Wajib — tanpa nilai yang benar, service terkait gagal start atau fitur intinya patah.
• Optional — sudah ada default yang aman, atau memang integrasi/fitur tambahan yang boleh dikosongkan (fitur terkait nonaktif secara aman, bukan error).
• Tanda (installer: …) — nilai ini di-generate/ditulis otomatis oleh installer alurkerja-cli (build-alurkerja): nilai Keycloak dari setup-keycloak.sh dan application secrets dari step Generate secrets. Jangan diisi manual duluan — installer hanya mengisi nilai yang masih kosong/placeholder dan tidak pernah me-rotate nilai yang sudah ada. Variabel tanpa tanda ini diisi user (langsung di .env, atau lewat wizard/flag installer untuk mode eksternal). Instalasi manual tanpa CLI: semua diisi sendiri.

1. Database Configuration (PostgreSQL)

Prasyarat Schema Database (public.sql) — Extension pgvector

config/public.sql (schema utama) butuh extension pgvector (vector) dan pg_trgm aktif di server PostgreSQL sebelum dijalankan — dipakai untuk kolom embedding (knowledge_chunks) dan pencarian trigram. Script ini sudah punya pre-flight check di baris awal yang akan gagal dengan pesan jelas kalau extension belum tersedia, daripada error samar di tengah jalan.

Postgres internal (docker-compose bawaan): sudah otomatis tersedia — service postgres di docker-compose.yml memakai image pgvector/pgvector:pg16 (bukan postgres:16-alpine polos). Tidak perlu langkah tambahan.

Postgres eksternal (mode --database external / managed sendiri): pgvector harus sudah terpasang/aktif di server tersebut sebelum menjalankan public.sql:

• Managed cloud Postgres (AWS RDS/Aurora, Supabase, Neon, Google Cloud SQL, Azure Database for PostgreSQL Flexible Server, dll) — pgvector biasanya sudah tersedia dari provider, cukup pastikan bisa CREATE EXTENSION vector; (script ini sudah melakukannya otomatis).
• Server self-managed (VM/bare metal sendiri) — install manual dulu mengikuti dokumentasi resmi pgvector.

2. Keycloak Configuration

3. MinIO / Storage Configuration

4. Redis / Cache Configuration

Redis untuk antrean (REDIS_QUEUE_*, container redis-queue) adalah instance terpisah dan tidak tercakup tabel di atas — lihat Env Konsolidasi Antrean (asynq).

5. Sentry Configuration

6. OpenAI Configuration

7. Email Configuration (Notification & Tenant Management)

8. JWT Configuration

9. Encryption Configuration (Tenant Settings)

10. Camunda Configuration (Migration Service)

11. GitLab Configuration (fitur tambahan — incident tracking)

12. Laravel Passport Configuration

13. Website / Application URL

14. Service Port Configuration

15. HTTP / Server Configuration

16. Report Service — Queue Processor

Flag rollout asynq (QUEUE_PROCESSOR_CONSUMER dan padanannya di integration/notification) serta env container relay ada di Env Konsolidasi Antrean (asynq).

17. Generate Test Service Specific

18. Upload Configuration

19. Public Domain & Origin

Blok ini ada di paling atas .env karena variabel lain merujuk ke sini lewat ${...} (Compose menginterpolasi .env berurutan). Ubah domain hanya di sini — atau lewat --update-domain (Section J); jangan sunting URL turunannya satu per satu.

Perhatian: Keycloak menyimpan web-origins & redirect URI di databasenya, jadi setelah mengubah blok ini secara manual jalankan docker compose run --rm tools scripts/update-web-origins.sh (tambah --dry-run untuk mengintip). Lewat --update-domain, sinkronisasi itu sudah jadi salah satu step.

20. MinIO Configuration (Additional)

21. Telegram Bot Configuration

22. WhatsApp API Configuration

23. Integration Configuration

24. App Configuration

25. Frontend — Runtime Injection (app-react & studio-react)

Di-inject ke conf.js saat container start via docker-entrypoint.sh.

26. Microsite Configuration (Next.js Application)

Perhatikan ejaannya: KEYCLOAK_ADMIN_SECREET, bukan SECRET — begitu integration-service membacanya (config/env.go); mengisi KEYCLOAK_ADMIN_SECRET (ejaan benar) tidak akan terbaca. Kalau kedua variabel ini kosong, integration-service otomatis memakai KEYCLOAK_CLIENT/KEYCLOAK_CLIENT_SECRET sebagai gantinya — cukup untuk instalasi default karena client itu dibuat confidential oleh setup-keycloak.sh. Isi keduanya secara eksplisit hanya kalau ingin service account terpisah.

Service account ini dipakai untuk dua hal, dan masing-masing butuh role Keycloak sendiri (Clients → client ini → Service accounts roles → Assign role → filter by clients → realm-management):

• Membuat/reset password user Keycloak saat tenant men-generate auth token integrasi (mis. dipakai addon n8n) → role manage-users.
• Impersonasi user untuk MCP tool calls (lihat Impersonate User) → role impersonation.

Kalau role ini belum ter-assign: pembuatan auth token integrasi gagal dengan 500 dari Keycloak, atau MCP tool call yang bertindak atas nama user tertentu ditolak. setup-keycloak.sh belum tentu meng-assign kedua role ini secara otomatis — cek langsung di Keycloak Admin Console kalau salah satu fitur di atas tidak jalan.

27. Frontend — Build-time Only (compro-react & simulation-react)

Bukan variabel di .env root. Image compro-react dan simulation-react tidak punya docker-entrypoint.sh untuk runtime injection, jadi VITE_* harus diisi manual di file terpisah sebelum image di-build:

• builds/compro-react/.env → VITE_API_BASEURL, VITE_API_TASKLIST_BASEURL, VITE_AUTH_METHOD, VITE_KEYCLOAK_*, VITE_SENTRY_DSN — Wajib diisi sebelum build, atau FE ini salah konfigurasi permanen sampai di-build ulang.
• builds/simulation-react/.env → VITE_KEYCLOAK_*, VITE_API_BASE_URL, VITE_SENTRY_DSN (opsional) — sama alasan.

I. Lifecycle Service: Start, Stop, Purge Data, Uninstall

alurkerja-cli hanya mengurus instalasi (build-alurkerja) — belum ada command lifecycle bawaan, jadi operasi setelah instalasi dijalankan langsung dengan docker compose.

Nama project compose diambil dari field name: di docker-compose.yml — bawaan repo: alurkerja (kalau field tidak ada, compose memakai nama folder download dalam huruf kecil). Dengan flag -p alurkerja, command ps, logs, start, stop, restart, dan down bisa dijalankan dari folder mana pun; hanya up yang wajib dari folder download, karena container harus dirakit ulang dari docker-compose.yml + .env.

Empat tingkat operasi — makin ke bawah makin banyak yang hilang:

I.1. Start service

Aksi

Setelah stop — container masih ada, cukup dinyalakan lagi (dari folder mana pun):

docker compose -p alurkerja start

Setelah down atau untuk instalasi yang baru saja di-up pertama kali — container harus dibuat ulang, jadi jalankan dari folder download:

docker compose up -d

Satu service saja: docker compose -p alurkerja start camunda.

Expected output

docker compose -p alurkerja ps

Semua service berstatus running. Boot penuh butuh ±1–2 menit: depends_on hanya mengatur urutan start, bukan kesiapan, jadi beberapa backend bisa restart sekali-dua kali selama postgres masih warm-up dan stabil sendiri karena restart: unless-stopped. Setelah itu aplikasi kembali dapat diakses di URL Step 9.

Perhatian: semua service memakai restart: unless-stopped — stack ikut nyala otomatis setiap Docker Desktop start. Container yang dihentikan manual (stop/down) tidak ikut nyala, jadi keputusan mematikan stack bertahan melewati reboot.

I.2. Stop service

Aksi

Ada dua tingkat, pilih sesuai kebutuhan.

a. stop — jeda harian. Container dihentikan tapi tetap ada; port host 8100–8105 dilepas; data dan konfigurasi utuh. Hidupkan lagi dengan start (I.1).

docker compose -p alurkerja stop

b. down — bongkar container. Container dan network alurkerja-net dihapus, volume tidak disentuh — semua data tetap aman. Dipakai kalau .env atau docker-compose.yml berubah dan container perlu dirakit ulang.

docker compose -p alurkerja down --remove-orphans

--remove-orphans ikut membersihkan container sisa service yang sudah tidak ada lagi di docker-compose.yml versi sekarang.

Expected output

docker compose -p alurkerja ps -a

Setelah stop: semua container berstatus exited. Setelah down: daftar kosong.

Perhatian: Mailpit tidak punya volume — email uji hilang setiap container dibuat ulang lewat down. stop tidak menghapusnya.

I.3. Purge data

Aksi

Stack ini membuat tiga volume (keycloak_data dideklarasikan di docker-compose.yml tapi tidak dipakai service mana pun, jadi tidak pernah terbentuk — Keycloak menyimpan realm-nya di database keycloak_db di dalam postgres):

a. Purge total — kosongkan semua data, instalasi tetap terpasang:

docker compose -p alurkerja down -v --remove-orphans

Lalu isi ulang schema dan realm dengan menjalankan pipeline lagi dari folder download:

alurkerja build-alurkerja

Step Init database, Load public & camunda schema, dan Setup Keycloak berjalan lagi; step Generate secrets hanya mengisi nilai yang kosong/masih placeholder, jadi 4 application secrets di .env tidak di-rotate dan instalasi baru memakai kunci yang sama.

b. Purge selektif — buang satu jenis data saja, mis. file storage:

docker compose -p alurkerja down          # container harus dihapus dulu, `stop` saja tidak cukup:
                                          # volume masih dipegang container yang exited
docker volume rm alurkerja_minio_data
docker compose up -d                      # dari folder download; minio-init membuat ulang bucket

Expected output

docker volume ls --filter name=alurkerja_

Volume yang dibuang tidak lagi muncul (setelah purge total: daftar kosong).

I.4. Uninstall service AlurKerja

Urutannya: matikan stack dulu, baru bersihkan jejak di luar Docker, terakhir hapus folder. Jalankan semua langkah agar tidak ada residu.

1. Stop stack & hapus volume

docker compose -p alurkerja down -v --remove-orphans

Expected: docker compose ls --all tidak lagi menampilkan project alurkerja, docker volume ls --filter name=alurkerja_ kosong, dan network alurkerja-net hilang dari docker network ls.

2. Hapus entri hosts yang ditulis CLI

Selama instalasi, CLI menambahkan satu baris ber-komentar # alurkerja-cli ke hosts file supaya domain lokal resolve ke mesin ini — mis. 127.0.0.1 alurkerja.local microsite-alurkerja.local minio-alurkerja.local # alurkerja-cli. Butuh akses admin/root:

$hosts = "$env:SystemRoot\System32\drivers\etc\hosts"
Set-Content $hosts -Value ((Get-Content $hosts) -notmatch 'alurkerja-cli')

sudo sed -i.bak '/# alurkerja-cli/d' /etc/hosts

Expected: Select-String alurkerja-cli $hosts (PowerShell) atau grep alurkerja-cli /etc/hosts tidak menghasilkan baris apa pun. Baris domain yang ditulis sendiri (tanpa komentar # alurkerja-cli) tidak ikut terhapus — hapus manual kalau memang tidak dipakai lagi.

3. Lepas root CA mkcert — hanya kalau instalasi memakai HTTPS lokal

Step Setup local HTTPS menjalankan mkcert -install, yang menaruh root CA lokal di trust store OS. Lepas kepercayaan itu sebelum folder ~/.alurkerja dihapus (binary mkcert ada di dalamnya):

& "$env:USERPROFILE\.alurkerja\bin\mkcert.exe" -uninstall

~/.alurkerja/bin/mkcert -uninstall

Perhatian: ini melepas root CA mkcert untuk semua project di mesin ini — lewati kalau ada project lain yang mengandalkannya.

4. Lepas reservasi port — Windows saja

CLI mereservasi 10 port mulai dari AK_PORT_NGINX (default 8100–8109) lewat netsh supaya Hyper-V/WSL tidak mencaploknya setelah reboot. Di terminal admin:

netsh int ipv4 delete excludedportrange protocol=tcp startport=8100 numberofports=10

Expected: netsh int ipv4 show excludedportrange protocol=tcp tidak lagi menampilkan baris 8100–8109. Kalau AK_PORT_NGINX di .env bukan 8100, sesuaikan startport (cek .env sebelum foldernya dihapus di langkah 5).

5. Hapus folder download

Hapus folder yang dipilih di Step 6 (berisi docker-compose.yml, .env, config/, sertifikat nginx/certs/):

Remove-Item -Recurse -Force D:\path\ke\folder-download

rm -rf /path/ke/folder-download

Perhatian: .env (termasuk application secrets) ikut terhapus bersama folder ini dan tidak bisa dipulihkan.

6. Logout Harbor

docker logout harbor.merapi.javan.id

7. Hapus image — opsional, mengosongkan ±5 GB

Image tetap tersimpan setelah down. Hapus image AlurKerja dari Harbor plus alurkerja-tools (image lokal hasil build service tools) — command sama untuk PowerShell maupun bash:

docker rmi $(docker images -q "harbor.merapi.javan.id/alurkerja-v2/*")
docker rmi alurkerja-tools

Image publik pendukung (nginx, keycloak, pgvector, redis, minio, mailpit) bisa dibersihkan dengan docker image prune -a — perhatian: perintah ini menghapus semua image yang tidak dipakai container mana pun, termasuk milik project lain.

I.5. Uninstall AlurKerja CLI

Aksi

Seluruh jejak CLI ada di satu folder: ~/.alurkerja (Windows: %USERPROFILE%\.alurkerja) — binary bin/alurkerja, binary bin/mkcert, config & profile koneksi, token login, serta deployment/. Jalankan mkcert -uninstall (I.4 langkah 3) sebelum folder ini dihapus.

Remove-Item -Recurse -Force "$env:USERPROFILE\.alurkerja"

# Lepas dari user PATH lewat registry — entri %VAR% lain tetap utuh
$dir      = Join-Path $env:USERPROFILE '.alurkerja\bin'
$key      = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment', $true)
$noExpand = [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames
$raw      = $key.GetValue('Path', '', $noExpand)
$kept     = "$raw" -split ';' -ne '' -ne $dir -ne "$dir\"
$key.SetValue('Path', ($kept -join ';'), [Microsoft.Win32.RegistryValueKind]::ExpandString)
$key.Close()

rm -rf ~/.alurkerja

Expected output

Di terminal baru (PATH lama masih hidup di terminal yang sedang terbuka), alurkerja --version menghasilkan command not found.

Perhatian: installer versi lama memasang binary di lokasi berbeda — %LOCALAPPDATA%\alurkerja (Windows) atau ~/.local/bin / ~/bin (macOS/Linux). Kalau CLI pernah dipasang sebelum pindah ke ~/.alurkerja/bin, cek lokasi itu dan hapus file alurkerja yang tersisa.

I.6. Verifikasi akhir

J. Skema Domain dan Ganti Domain

Ada dua skenario pemakaian:

Sumber kebenarannya satu: blok domain di .env (NGINX_DOMAIN, MICROSITE_DOMAIN, MINIO_DOMAIN, PUBLIC_SCHEME, PUBLIC_PORT_SUFFIX). Semua *_ORIGIN dan URL frontend diturunkan dari situ lewat interpolasi ${...}, jadi tidak ada URL yang perlu diedit satu per satu.

J.1. Peta URL kedua skenario

SSO mengikuti domain utama dengan sendirinya (SSO_DOMAIN=${NGINX_DOMAIN}${PUBLIC_PORT_SUFFIX}/sso). Kalau SSO-nya justru harus di host terpisah — mis. Keycloak eksternal di sso.alurkerja.dev — pakai --sso-domain sso.alurkerja.dev: CLI menguji koneksi ke port 443-nya lebih dulu, dan realm + client di sana harus sudah ada.

J.2. Ganti domain pada instalasi existing

Aksi

Jalankan dari folder download (atau tambahkan --dir <folder>):

alurkerja build-alurkerja --update-domain --domain alurkerja.dev

Tanpa flag pun bisa: jalankan alurkerja build-alurkerja di folder instalasi, lalu pilih Update the public domain (app, studio, sso) di menu instalasi existing. Nilai yang tidak diisi diambil dari .env saat ini — enter kosong = biarkan apa adanya.

Jalur ini 5 step, di luar pipeline install biasa:

Expected output

Step Summary menampilkan kelima URL di domain baru, dan Domain updated in <durasi>. tampil di akhir.

Perhatian: entri hosts dari instalasi lokal sebelumnya tidak ikut dihapus. Kalau domain lokal sudah tidak dipakai, bersihkan sesuai Section I.4 langkah 2.