btnmw-server-local/docs/setup-gitlab.md

Setup GitLab

Panduan ini menjelaskan cara menjalankan dan mengkonfigurasi GitLab lokal untuk project BTN Middleware.

---

1. Jalankan container GitLab

Dari root project, jalankan:

docker compose up -d gitlab

---

2. Pastikan GitLab healthy

GitLab membutuhkan beberapa menit untuk inisialisasi pertama kali. Cek status container:

docker compose ps gitlab

Pastikan kolom STATUS menunjukkan Up (healthy).

3. Buka GitLab di browser

Akses URL berikut:

http://localhost:10806

---

4. Login sebagai root

Gunakan kredensial berikut:

Field	Nilai
Username	root
Password	lihat command di bawah

Ambil password awal root dengan:

docker exec gitlab cat /etc/gitlab/initial_root_password

Cari baris Password: — itu password untuk user root.

File password ini hanya valid ~24 jam setelah GitLab pertama kali di-setup, dan hanya jika password belum diubah manual.

---

5. Buat user baru

Setelah login sebagai root, buat user baru. Untuk membuat user baru pergi ke halaman http://localhost:10806/admin/users/new

Penting: User yang akan digunakan untuk development adalah user baru ini, bukan user root/admin. Jangan gunakan akun root untuk aktivitas sehari-hari.

Alternatif: user baru juga bisa mendaftar lewat tombol Register, namun akun tersebut perlu disetujui admin (root) terlebih dahulu sebelum bisa login.

---

6. Login dengan user baru & buat group

1. Logout dari akun root, lalu login dengan user baru yang sudah dibuat.
2. Buat group dengan nama btnmw atau bsnmw.

---

Setup GitLab selesai.

Kembali ke Setup Project.