mirror of
https://github.com/mivodev/mivo.git
synced 2026-01-26 21:41:59 +07:00
feat: Initialize VitePress documentation system with multi-language content, custom theme, and assets.
This commit is contained in:
dyzulk
77
docs/id/guide/docker.md
Normal file
77
docs/id/guide/docker.md
Normal file
@@ -0,0 +1,77 @@
|
||||
---
|
||||
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 \
|
||||
dyzulk/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: dyzulk/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!
|
||||
|
||||
[](https://sociabuzz.com/dyzulkdev/tribe)
|
||||
|
||||
---
|
||||
*Dibuat dengan <Icon name="Heart" color="danger" /> oleh DyzulkDev*
|
||||
23
docs/id/guide/index.md
Normal file
23
docs/id/guide/index.md
Normal file
@@ -0,0 +1,23 @@
|
||||
---
|
||||
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. MIVO merupakan penulisan ulang total dari Mikhmon v3 yang legendaris, dirancang ulang untuk performa yang lebih baik dan pengalaman pengguna yang premium.
|
||||
|
||||
## <Icon name="BookOpen" color="primary" /> Navigasi
|
||||
|
||||
Jelajahi bagian berikut untuk memulai:
|
||||
|
||||
- **[Panduan Instalasi](/id/guide/installation)**: Pelajari cara menginstal MIVO di berbagai platform.
|
||||
- **[Panduan Docker](/id/guide/docker)**: Cara yang direkomendasikan untuk menjalankan MIVO menggunakan container.
|
||||
- **[Buku Manual](/id/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.
|
||||
121
docs/id/guide/installation.md
Normal file
121
docs/id/guide/installation.md
Normal file
@@ -0,0 +1,121 @@
|
||||
---
|
||||
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 dyzulk/mivo:latest # Stable
|
||||
docker pull dyzulk/mivo:v1.0.0 # Versi Spesifik
|
||||
docker pull dyzulk/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.
|
||||
|
||||
Reference in New Issue
Block a user