Cara Ganti Port pada Multica Self-Hosted Localhost

Terbit pada
3 menit baca.
Tags: DevOpsAI

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.