README.MD

@@ -0,0 +1,97 @@
+# BTN Middleware Server Local
+
+Projek ini adalah Environment Docker untuk menjalankan stack middleware BTN secara lokal (GitLab, Jenkins, database DB2 (mwconfig & mwlog), dan IBM ACE).
+
+## Requirements
+
+- Jalankan di linux/wsl2
+- Docker & Docker Compose terinstal
+
+---
+
+## Setup
+
+### 1. (Opsional) Fork project
+
+Fork repository ini ke akun gitlab masing-masing jika ingin menyimpan perubahan konfigurasi sendiri.
+
+### 2. Clone project
+
+```bash
+git clone https://code.senomas.com/wisnu/btnmw-server-local
+cd btnmw-server-local
+```
+
+### 3. Login ke Docker registry Senomas
+
+Gunakan kredensial yang telah diberikan:
+
+```bash
+docker login docker.senomas.com
+```
+
+### 4. Pull image
+
+Download semua image yang dibutuhlan dari registry:
+
+```bash
+docker compose pull
+```
+
+---
+
+## Menjalankan Project
+
+### 1. (Opsional) Build image
+
+```bash
+docker compose build
+```
+Kapan perlu dijalankan?
+- Pertama kali setup (belum pernah build Jenkins)
+- Ada perubahan pada `jenkins/jenkins/Dockerfile` atau file terkait
+
+### 2. Jalankan GitLab dan Jenkins
+
+```bash
+docker compose up -d gitlab jenkins
+```
+
+#### 2.1 Pastikan GitLab sudah siap
+
+GitLab membutuhkan waktu beberapa menit untuk inisialisasi. Cek status container:
+
+```bash
+docker compose ps gitlab
+```
+
+Pastikan kolom STATUS menunjukkan `Up` (bukan `starting` atau `restarting`).
+
+### 3. Jalankan ACE (middleware)
+
+```bash
+make ace
+```
+
+---
+
+
+## Useful Commands
+
+- Hentikan stack ACE (mwconfig, mwlog, btn-middleware):
+
+```bash
+make ace-down
+```
+
+- Hentikan semua container beserta volume:
+
+```bash
+make down
+```
+
+- Lihat status semua container:
+
+```bash
+docker compose ps
+```