Instalasi

SiDesa dapat dijalankan dengan dua cara: native (lokal) atau Docker Compose.

Versi

Berdasarkan composer.json: PHP ^8.1 dan Laravel ^10.10. Pastikan Anda berada di branch develop.

---

Opsi 1: Instalasi Lokal (Native)

1. Clone Repositori

# SSH (rekomendasi)
git clone git@github.com:TIMA-Codecraft/sidesa.git

# atau HTTPS
git clone https://github.com/TIMA-Codecraft/sidesa.git

cd sidesa
git checkout develop

2. Pasang Dependensi

composer install
npm install

3. Konfigurasi Environment

cp .env.example .env
php artisan key:generate

Sesuaikan koneksi database pada .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=sidesa
DB_USERNAME=root
DB_PASSWORD=

Detail seluruh variabel dibahas di Konfigurasi Environment.

4. Migrasi Database & Seeder

php artisan migrate --seed

Seeder menghasilkan:

• 5 role (superadmin, kades, perangkat, rt, warga) beserta permission-nya.
• Akun demo (password semua akun: password).
• Data dummy kependudukan, template surat, konten, menu, APBDes/Peta, dan PPID.

5. Build Asset & Jalankan Server

# terminal 1 — server aplikasi
php artisan serve

# terminal 2 — build asset admin (Vite/Tailwind)
npm run dev

Buka http://localhost:8000 (atau http://localhost:8000/install untuk wizard instalasi).

---

Opsi 2: Docker Compose

Konfigurasi Docker tersedia di docker-compose.yml (dua service: app PHP-FPM dan web Nginx).

git clone git@github.com:TIMA-Codecraft/sidesa.git
cd sidesa

cp .env.example .env
docker compose up -d --build

Setup dependensi dan migrasi di dalam container:

docker compose exec app composer install
docker compose exec app php artisan key:generate
docker compose exec app php artisan migrate --seed

Variabel	Default	Keterangan
APP_PORT	8080	Port Nginx di host
DB_HOST	host.docker.internal	Alamat database yang berjalan di luar container (host machine)

Aplikasi dapat diakses di http://localhost:8080.

Catatan

Container app menggunakan extra_hosts: host.docker.internal agar dapat menjangkau MariaDB/MySQL yang berjalan di luar container. Ubah DB_HOST pada .env jika database ikut dikemas sebagai service terpisah.

---

Langkah Selanjutnya

• Login pertama kali → lihat Masuk & Akun Pengguna.
• Ganti data demo → Data Kartu Keluarga dan Data Penduduk.
• Mengembangkan tema → Sistem Multi-Tema.