Update docs structure to root and fix links

2026-01-26 05:25:36 +07:00 · 2026-01-18 11:35:30 +07:00
parent c977c8dc1b
commit 2ef1f20e54
80 changed files with 227 additions and 188 deletions
--- a/id/docs/guide/docker-aapanel.md
+++ b/id/docs/guide/docker-aapanel.md
@@ -0,0 +1,105 @@
+# Deploy di aaPanel (Docker)
+
+aaPanel adalah salah satu panel hosting paling populer yang memiliki modul **Docker Manager** yang sangat memudahkan manajemen container. Kami merekomendasikan penggunaan gaya "Native" aaPanel agar manajemen resource dan env lebih rapi.
+
+::: tip PRASYARAT
+Pastikan Anda sudah menginstall modul **Docker** dari App Store di dalam aaPanel Anda.
+:::
+
+## 1. Siapkan Konfigurasi
+
+Metode ini memisahkan konfigurasi (di file `.env`) dari template logic, sehingga Anda bisa dengan mudah mengubah port atau resource limit tanpa mengedit file YAML yang rumit.
+
+**File Environment (`.env`)**
+Buat file baru bernama `.env` (atau simpan teks ini untuk nanti):
+
+```ini
+VERSION=latest
+CONTAINER_NAME=mivo
+HOST_IP=0.0.0.0
+APP_PORT=8085
+APP_PATH=/www/dk_project/mivo
+APP_ENV=production
+APP_DEBUG=false
+TZ=Asia/Jakarta
+CPUS=1.0
+MEMORY_LIMIT=512M
+```
+
+**Penjelasan Atribut:**
+- `APP_PATH`: **Penting**. Ini harus sama persis dengan lokasi project di aaPanel Anda (defaultnya `/www/dk_project/<nama_project>`).
+- `APP_PORT`: Port host yang ingin dibuka (default `8080`).
+- `CPUS` & `MEMORY_LIMIT`: Batasan resource agar container tidak membebani server/VPS Anda.
+
+## 2. Buat Project di aaPanel
+
+1. Login ke dashboard aaPanel.
+2. Masuk ke menu **Docker** > **Project** (atau **Compose** di versi lama).
+3. Klik tombol **Add Project**.
+4. Isi form sebagai berikut:
+   - **Name**: `mivo` (atau nama lain yang Anda suka)
+   - **Path**: Perhatikan path yang muncul otomatis (biasanya `/www/dk_project/mivo`). **Pastikan `APP_PATH` di .env Anda sesuai dengan path ini!**
+   - **Compose Template**: Copy-paste kode YAML berikut:
+
+```yaml
+version: '3.8'
+
+services:
+  mivo:
+    image: ghcr.io/mivodev/mivo:${VERSION:-latest}
+    container_name: ${CONTAINER_NAME:-mivo}
+    restart: unless-stopped
+    ports:
+      - "${HOST_IP:-0.0.0.0}:${APP_PORT:-8085}:80"
+    volumes:
+      # Database & Sessions
+      - ${APP_PATH:-.}/mivo_data:/var/www/html/app/Database
+      
+      # Custom Logos
+      - ${APP_PATH:-.}/mivo_logos:/var/www/html/public/assets/img/logos
+      
+      # Environment file (Optional - mapped from host)
+      # - ${APP_PATH:-.}/.env:/var/www/html/.env
+      
+    environment:
+      - APP_ENV=${APP_ENV:-production}
+      - APP_DEBUG=${APP_DEBUG:-false}
+      - TZ=${TZ:-Asia/Jakarta}
+      
+    deploy:
+      resources:
+        limits:
+          cpus: '${CPUS:-1.0}'
+          memory: ${MEMORY_LIMIT:-512M}
+
+    networks:
+      - mivo_net
+
+networks:
+  mivo_net:
+    driver: bridge
+```
+
+5. **Tunggu!** Sebelum klik "Confirm":
+   - Cari bagian konfigurasi **.env** (biasanya berupa tab atau input area di samping/bawah editor YAML).
+   - Paste konten `.env` yang sudah Anda siapkan di langkah 1 ke sana.
+6. Klik **Confirm** untuk memulai deployment.
+
+## 3. Verifikasi Deployment
+
+aaPanel akan otomatis mendownload image dan menjalankan container.
+
+- **Lokasi Data**: Database Anda aman tersimpan di `/www/dk_project/mivo/mivo_data`. folder ini tidak akan hilang walau container dihapus.
+- **Lokasi Logo**: Upload logo kustom Anda ke `/www/dk_project/mivo/mivo_logos`.
+
+## 4. Setup Domain (Reverse Proxy)
+
+Agar MIVO bisa diakses menggunakan domain (contoh: `mivo.domainanda.com`):
+
+1. Ke menu **Website** > **Add Site**.
+2. Masukkan nama domain Anda.
+3. Pada **PHP Version**, pilih **Static** (atau langsung Reverse Proxy jika ada opsinya).
+4. Setelah site dibuat, buka settingannya > **Reverse Proxy** > **Add Reverse Proxy**.
+5. **Target URL**: `http://127.0.0.1:8085` (Ganti `8085` sesuai dengan `APP_PORT` Anda).
+6. Simpan dan aktifkan SSL agar lebih aman.
+
--- a/id/docs/guide/docker.md
+++ b/id/docs/guide/docker.md
@@ -0,0 +1,78 @@
+---
+title: Panduan Docker
+---
+
+# Panduan Docker
+
+Image Docker ini dibangun di atas **Alpine Linux** dan **Nginx**, dioptimalkan untuk performa tinggi dan penggunaan sumber daya rendah.
+
+## <Icon name="Zap" color="warning" /> Mulai Cepat
+
+Jalankan MIVO dengan satu perintah:
+
+```bash
+docker run -d \
+  --name mivo \
+  -p 8080:80 \
+  -e APP_KEY=base64:YOUR_GENERATED_KEY \
+  -e APP_ENV=production \
+  -v mivo_data:/var/www/html/app/Database \
+  -v mivo_config:/var/www/html/.env \
+  ghcr.io/mivodev/mivo:latest
+```
+
+Buka browser Anda dan navigasi ke `http://localhost:8080`.
+
+**Pengaturan Awal:**
+Jika ini adalah pertama kali dijalankan, Anda akan diarahkan ke **Web Installer**. Ikuti instruksi di layar untuk membuat database dan akun admin.
+
+## <Icon name="Wrench" color="primary" /> Docker Compose
+
+Untuk pengaturan yang lebih permanen, gunakan `docker-compose.yml`:
+
+```yaml
+services:
+  mivo:
+    image: ghcr.io/mivodev/mivo:latest
+    container_name: mivo
+    restart: unless-stopped
+    ports:
+      - "8080:80"
+    environment:
+      - APP_ENV=production
+      - TZ=Asia/Jakarta
+    volumes:
+      - ./mivo-data:/var/www/html/app/Database
+```
+
+## <Icon name="Tags" color="info" /> Tags
+
+- `latest`: Rilis stabil (direkomendasikan).
+- `edge`: Build terbaru dari branch `main` (bleeding edge).
+- `v1.x.x`: Versi rilis spesifik.
+
+## <Icon name="Sliders" color="success" /> Variabel Lingkungan
+
+| Variabel | Deskripsi | Default |
+| :--- | :--- | :--- |
+| `APP_ENV` | Lingkungan aplikasi (`production` atau `local`). | `production` |
+| `APP_DEBUG` | Aktifkan mode debug (`true` atau `false`). | `false` |
+| `APP_KEY` | String acak ca 32-karakter (base64). Dibuat otomatis saat install pertama kali jika kosong. | |
+| `TZ` | Zona waktu untuk container. | `UTC` |
+
+## <Icon name="Folder" color="primary" /> Volume
+
+Persist data Anda dengan me-mount path ini:
+
+- `/var/www/html/app/Database`: Menyimpan database SQLite dan file sesi. **(Penting)**
+- `/var/www/html/public/assets/img/logos`: Menyimpan logo kustom yang diupload.
+
+## <Icon name="Heart" color="danger" /> Dukung Proyek Ini
+
+Jika Anda merasa MIVO bermanfaat, harap pertimbangkan untuk mendukung pengembangannya. Kontribusi Anda sangat berarti untuk kelangsungan proyek ini!
+
+[![SociaBuzz Tribe](https://img.shields.io/badge/SociaBuzz-Tribe-green?style=for-the-badge&logo=sociabuzz&logoColor=white)](https://sociabuzz.com/dyzulkdev/tribe)
+
+---
+*Dibuat dengan <Icon name="Heart" color="danger" /> oleh MivoDev*
+
--- a/id/docs/guide/index.md
+++ b/id/docs/guide/index.md
@@ -0,0 +1,24 @@
+---
+title: Pengenalan
+---
+
+# Pengenalan
+
+Selamat datang di Panduan MIVO. Bagian ini akan membantu Anda memahami apa itu MIVO dan bagaimana cara menjalankannya di sistem Anda.
+
+## <Icon name="Zap" color="warning" /> Apa itu MIVO?
+
+MIVO adalah sistem Manajemen Voucher Mikrotik yang modern dan ringan. Sistem ini dirancang agar efisien, cepat, dan mudah digunakan, memberikan pengalaman yang mulus untuk pengelolaan Hotspot.
+
+## <Icon name="BookOpen" color="primary" /> Navigasi
+
+Jelajahi bagian berikut untuk memulai:
+
+- **[Panduan Instalasi](/id/docs/guide/installation)**: Pelajari cara menginstal MIVO di berbagai platform.
+- **[Panduan Docker](/id/docs/guide/docker)**: Cara yang direkomendasikan untuk menjalankan MIVO menggunakan container.
+- **[Buku Manual](/id/docs/manual/)**: Instruksi detail tentang cara menggunakan fitur-fitur MIVO.
+
+## <Icon name="Heart" color="danger" /> Dukungan
+
+MIVO adalah proyek open-source. Jika Anda merasa MIVO bermanfaat, harap pertimbangkan untuk mendukung pengembangannya melalui [donasi](https://sociabuzz.com/dyzulkdev/tribe) atau [berkontribusi](https://github.com/dyzulk/mivo) langsung ke kode program.
+
--- a/id/docs/guide/installation.md
+++ b/id/docs/guide/installation.md
@@ -0,0 +1,122 @@
+---
+title: Panduan Instalasi
+---
+
+# Panduan Instalasi
+
+Panduan ini mencakup instalasi di berbagai platform. MIVO dirancang agar ringan dan berjalan di hampir semua server yang mendukung PHP.
+
+## <Icon name="ClipboardList" color="primary" /> Persyaratan Umum {#persyaratan}
+*   **PHP**: 8.0 atau lebih tinggi
+*   **Ekstensi**: `sqlite3`, `openssl`, `mbstring`, `json`
+*   **Database**: SQLite (Berbasis file, tidak perlu server database)
+
+---
+
+## <Icon name="Container" color="info" /> Docker (Direkomendasikan) {#docker}
+Cara termudah untuk menjalankan MIVO.
+
+1.  **Build & Run**
+    ```bash
+    docker-compose up -d --build
+    ```
+    Buka `http://localhost:8080`
+    
+2.  **Manual Pull (Alternatif)**
+    Jika Anda lebih suka menarik image secara manual:
+    ```bash
+    docker pull ghcr.io/mivodev/mivo:latest  # Stable
+    docker pull ghcr.io/mivodev/mivo:v1.0.0  # Versi Spesifik
+    docker pull ghcr.io/mivodev/mivo:edge    # Bleeding Edge
+    ```
+
+*Catatan: Database disimpan secara permanen di `app/Database` melalui volume.*
+
+---
+
+## <Icon name="Server" color="success" /> Web Server {#web-server}
+
+### Nginx
+Nginx tidak membaca `.htaccess`. Gunakan blok konfigurasi ini di blok `server` Anda:
+
+```nginx
+server {
+    listen 80;
+    server_name domain-anda.com;
+    root /path/to/mivo/public;
+    index index.php;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        include snippets/fastcgi-php.conf;
+        fastcgi_pass unix:/run/php/php8.2-fpm.sock; # Sesuaikan versi
+    }
+
+    location ~ /\.ht {
+        deny all;
+    }
+}
+```
+
+---
+
+## <Icon name="Smartphone" color="warning" /> Mobile / STB {#mobile-stb}
+
+### Awebserver
+1.  Salin file MIVO ke folder `/htdocs`.
+2.  Arahkan document root ke `public` jika didukung, atau akses via `http://localhost:8080/public`.
+3.  Pastikan versi PHP kompatibel.
+
+### Termux
+1.  Install PHP: `pkg install php`
+2.  Masuk ke direktori MIVO: `cd mivo`
+3.  Gunakan built-in server:
+    ```bash
+    php mivo serve --host=0.0.0.0 --port=8080
+    ```
+4.  Akses melalui browser.
+
+---
+
+## <Icon name="Globe" color="info" /> Shared Hosting {#shared-hosting}
+Kebanyakan shared hosting menggunakan Apache atau OpenLiteSpeed, yang didukung penuh.
+
+1.  **Upload File**: Upload file MIVO ke `public_html/mivo` (atau folder subdomain).
+2.  **Arahkan Domain**:
+    *   **Direkomendasikan**: Pergi ke "Domains" atau "Subdomains" di cPanel dan set **Document Root** agar menunjuk langsung ke folder `public/` (contoh: `public_html/mivo/public`).
+    *   **Alternatif**: Jika tidak bisa mengubah Document Root, Anda bisa memindahkan isi `public/` ke root `public_html` dan memindahkan `app/`, `routes/`, dll satu level ke atas (tidak disarankan untuk keamanan).
+3.  **Versi PHP**: Pilih PHP 8.0+ di menu "Select PHP Version".
+4.  **Ekstensi**: Pastikan `sqlite3` dan `fileinfo` dicentang.
+
+---
+
+## <Icon name="Cloud" color="primary" /> VPS & Cloud {#vps-cloud}
+
+### aaPanel
+1.  **Buat Website**: Tambah situs -> PHP-8.x.
+2.  **Direktori Situs**:
+    *   Set **Running Directory** ke `/public`.
+    *   Hapus centang "Anti-XSS" (terkadang memblokir penyimpanan konfigurasi).
+3.  **URL Rewrite**: Pilih template `thinkphp` atau `laravel` yang kompatibel.
+4.  **Izin File**: Chown user `www` ke direktori situs.
+
+### PaaS Cloud (Railway / Render / Heroku)
+> [!WARNING]
+> MIVO menggunakan SQLite. Kebanyakan PaaS Cloud menggunakan **Ephemeral Filesytem** (Data hilang saat restart).
+> Anda WAJIB menggunakan **Persistent Volume/Disk**.
+
+---
+
+## <Icon name="Settings" color="success" /> Pasca-Instalasi {#pasca-instalasi}
+Setelah menyiapkan server:
+1.  Salin `.env.example` ke `.env` (jika belum dilakukan).
+2.  **Install Aplikasi**
+    *   **Opsi A: CLI**
+        Jalankan `php mivo install` di terminal Anda.
+    *   **Opsi B: Web Installer**
+        Buka `http://domain-anda.com/install` di browser.
+
+