1. Persyaratan Sistem

Minimum Hardware

Software yang Dibutuhkan

Windows

• Windows 10/11 (64-bit)
• Docker Desktop for Windows
• WSL 2 (akan diinstall otomatis oleh Docker Desktop)

Linux

• Ubuntu 20.04+ / Debian 11+ / CentOS 8+
• Docker Engine
• Docker Compose

2. Instalasi di Windows (Docker Desktop)

1Install Docker Desktop

1. Download Docker Desktop dari https://www.docker.com/products/docker-desktop
2. Jalankan installer dan ikuti petunjuk instalasi
3. Restart komputer jika diminta
4. Buka Docker Desktop dan tunggu sampai status "Running"

2Siapkan Folder Aplikasi

1. Extract folder itams_app ke lokasi yang diinginkan, contoh:

   D:\ITAM\itams_app

2. Pastikan struktur folder seperti berikut:

3Jalankan Aplikasi

Cara 1: One-Click Deploy (Recommended)

1. Double-click file deploy.bat
2. Tunggu proses build dan deployment selesai
3. Browser akan terbuka otomatis ke http://localhost:8001

Cara 2: Manual via Command Prompt

1. Buka Command Prompt atau PowerShell
2. Masuk ke folder itams_app:

   cd D:\ITAM\itams_app

3. Jalankan perintah:

   docker-compose up -d --build

4. Tunggu sampai semua container running (± 5-10 menit)

4Verifikasi Instalasi

1. Buka browser dan akses: http://localhost:8001
2. Anda akan melihat halaman aktivasi lisensi
3. Hubungi administrator untuk mendapatkan kunci lisensi

3. Instalasi di Linux

1Install Docker Engine

Ubuntu/Debian

# Update package index
sudo apt-get update

# Install dependencies
sudo apt-get install -y ca-certificates curl gnupg

# Add Docker GPG key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Add Docker repository
echo "deb [arch=$(dpkg --print-architecture) \
  signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli \
  containerd.io docker-compose-plugin

# Start Docker
sudo systemctl start docker
sudo systemctl enable docker

# Add user to docker group (optional)
sudo usermod -aG docker $USER

CentOS/RHEL

# Install dependencies
sudo yum install -y yum-utils

# Add Docker repository
sudo yum-config-manager --add-repo \
  https://download.docker.com/linux/centos/docker-ce.repo

# Install Docker
sudo yum install -y docker-ce docker-ce-cli \
  containerd.io docker-compose-plugin

# Start Docker
sudo systemctl start docker
sudo systemctl enable docker

2Siapkan Folder Aplikasi

# Buat folder aplikasi
mkdir -p /opt/itam
cd /opt/itam

# Extract atau copy folder itams_app ke sini

3Jalankan Aplikasi

Cara 1: One-Click Deploy

cd /opt/itam/itams_app
chmod +x deploy.sh
./deploy.sh

Cara 2: Manual

cd /opt/itam/itams_app
docker compose up -d --build

4Konfigurasi Firewall (Optional)

# Untuk UFW (Ubuntu)
sudo ufw allow 8001/tcp
sudo ufw allow 3001/tcp

# Untuk firewalld (CentOS)
sudo firewall-cmd --permanent --add-port=8001/tcp
sudo firewall-cmd --permanent --add-port=3001/tcp
sudo firewall-cmd --reload

5Verifikasi Instalasi

# Cek status container
docker ps

# Output yang diharapkan:
# NAMES                 STATUS              PORTS
# it_asset_frontend     Up                  0.0.0.0:8001->80/tcp
# it_asset_backend      Up                  0.0.0.0:3001->3001/tcp
# it_asset_db           Up (healthy)        0.0.0.0:3308->3306/tcp

Akses aplikasi di browser: http://<IP-SERVER>:8001

4. Aktivasi Lisensi

Mendapatkan Hardware ID

1. Buka halaman aplikasi di browser
2. Anda akan melihat halaman aktivasi lisensi
3. Catat Hardware ID yang ditampilkan
4. Kirim Hardware ID ke administrator untuk mendapatkan kunci lisensi

Memasukkan Kunci Lisensi

1. Paste kunci lisensi yang diberikan ke form input
2. Klik tombol Aktivasi
3. Jika berhasil, Anda akan diarahkan ke halaman login

Informasi Login Default

5. Troubleshooting

Container Tidak Mau Start

# Cek log container
docker logs it_asset_backend
docker logs it_asset_db

# Restart semua container
docker-compose down
docker-compose up -d --build

Database Error / Connection Refused

# Tunggu database healthy (± 60 detik)
docker-compose ps

# Reset database (HATI-HATI: Data akan hilang!)
docker-compose down -v
docker-compose up -d --build

Port Sudah Digunakan

Edit file docker-compose.yml dan ubah port:

# Ubah port frontend dari 8001 ke 8080
ports:
  - "8080:80"

# Ubah port backend dari 3001 ke 3002
ports:
  - "3002:3001"

Login Gagal

1. Pastikan sudah aktivasi lisensi
2. Cek apakah user ada di database:

   docker exec it_asset_db mysql -uroot -proot123 \
     -e "SELECT username FROM it_asset_db.users;"