Multica self-hosted memakai port default yang juga diincar banyak tool dev lain: frontend di 3000, backend di 8080. Project kerja utama saya sudah jalan di localhost:3000, jadi Multica harus pindah port. Ini cara mengganti port-nya tanpa menyentuh Docker image.
Solusi singkat
Atur host port di .env Multica, restart stack, lalu arahkan CLI ke URL baru:
# .env
PORT=8765
FRONTEND_PORT=4321
make selfhost-stop && make selfhost
multica setup self-host --server-url http://localhost:8765 --app-url http://localhost:4321
Langkah 1: Edit .env
Buka .env di root repo Multica, lalu ubah dua host port ini:
PORT=8765
FRONTEND_PORT=4321
PORT untuk backend, FRONTEND_PORT untuk web app. Pilih port apa saja yang tidak bentrok dengan project lain.
Ini cuma host port. Di dalam Docker, container tetap listen di 8080 dan 3000, jadi tidak perlu rebuild apa pun.
Cek juga FRONTEND_ORIGIN. Di .env.example bawaan nilainya http://localhost:${FRONTEND_PORT}, jadi otomatis ikut port baru. Kalau sebelumnya kamu menulis nilainya langsung (hardcode), ubah juga. Kalau tidak, login akan gagal karena CORS.
Langkah 2: Restart stack
make selfhost-stop && make selfhost
Docker Compose membaca .env saat start, jadi port baru langsung dipakai.
Langkah 3: Arahkan CLI ke port baru
multica setup self-host mengasumsikan port 8080 dan 3000. Beri URL baru secara eksplisit:
multica setup self-host --server-url http://localhost:8765 --app-url http://localhost:4321
Command ini memperbarui config CLI, membuka browser untuk login, dan me-restart daemon.
Cek hasilnya
curl http://localhost:8765/health
Backend seharusnya membalas dengan respons healthy. Setelah itu buka http://localhost:4321, dan kamu akan masuk ke halaman login Multica.
Bagaimana dengan PostgreSQL di 5432?
Di mode self-host, port ini tidak perlu diubah. docker-compose.selfhost.yml tidak mem-publish Postgres ke mesin kamu. Backend terhubung ke Postgres lewat network Docker, jadi tidak mungkin bentrok dengan Postgres lokal.
Ini baru berpengaruh kalau kamu menjalankan setup dev Multica dengan docker-compose.yml, yang melakukan binding ke 127.0.0.1:5432:5432. Kalau bentrok, ubah sisi host dari binding itu, lalu samakan POSTGRES_PORT dan DATABASE_URL di .env:
ports:
- "127.0.0.1:${POSTGRES_PORT:-5499}:5432"
Ringkasan langkah
Untuk mengganti port Multica self-hosted: atur PORT dan FRONTEND_PORT di .env, restart dengan make selfhost, lalu jalankan ulang multica setup self-host dengan --server-url dan --app-url. Postgres tidak perlu disentuh kecuali kamu memakai compose file untuk dev.