# Setup GitLab

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

---

## 1. Jalankan container GitLab

Dari root project, jalankan:

```bash
docker compose up -d gitlab
```

---

## 2. Pastikan GitLab healthy

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

```bash
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:

```bash
docker exec gitlab cat /etc/gitlab/initial_root_password
```

Cari baris `Password:` itu password untuk user `root`.

![Password GitLab](./gitlab-pass.png)

> 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](README.MD).