Instalasi POS Berbasis WEB dengan Source OpenSourcePOS 3.4.1 Repo GitHUB

Instalasi POS Berbasis WEB dengan Source OpenSourcePOS 3.4.1 Repo GitHUB

🧰 Langkah-langkah Menyiapkan Lingkungan Pengembangan OSPOS di Windows 11

1. Clone Repo OSPOS

git clone https://github.com/opensourcepos/opensourcepos.git
cd opensourcepos

Jangan lupa pastikan Git sudah terinstal di sistem kamu.

2. Siapkan Database MySQL

• Jalankan XAMPP dan aktifkan Apache dan MySQL.
• Buat database baru, misalnya: ospos_dev
• Import file SQL:

mysql -u root -p ospos_dev < app/Database/database.sql

3. Konfigurasi File .env

• Salin file .env.example menjadi .env
• Ubah konfigurasi database sesuai setup kamu:

database.default.hostname = localhost
database.default.database = ospos_dev
database.default.username = root
database.default.password = password
CI_ENVIRONMENT = development

4. Install Dependency PHP via Composer

composer install

Pastikan Composer versi 2.8.10 sudah terdeteksi di PATH.

5. Install Dependency Frontend

npm install

Ini akan menginstal semua package frontend yang dibutuhkan OSPOS.

6. Build Frontend Assets

npm run build

Ini akan menghasilkan file CSS dan JS yang siap digunakan di aplikasi.

7. Jalankan Aplikasi

• Arahkan browser ke: http://localhost/opensourcepos/public
• Login default:

• Username: admin
• Password: pointofsale

⚙️ Catatan Tambahan

• Pastikan PHP di XAMPP mendukung ekstensi: json, gd, bcmath, intl, openssl, mbstring, curl, dan xml.
• Kalau kamu ingin debugging lebih mudah, aktifkan display_errors di php.ini.

✅ Isi encryption.key Dengan Nilai Acak Aman

Kamu bisa generate secara manual menggunakan terminal di VS Code atau PowerShell:

php -r "echo bin2hex(random_bytes(32));"

Hasilnya akan jadi string hex panjang seperti:

e9f9b34d8a2a509cb1851437cc9d77f2d6583b14e08dd02b3fd87c5cd7c81db2

Lalu salin hasilnya ke dalam .env:

encryption.key = e9f9b34d8a2a509cb1851437cc9d77f2d6583b14e08dd02b3fd87c5cd7c81db2

🎯 Tips Tambahan

• Jangan ubah encryption.key setelah aplikasi live, karena akan membuat data yang sudah terenkripsi tidak bisa didekripsi lagi.
• Simpan backup key di tempat aman.
• Kalau kamu pakai Git, pastikan .env tidak di-commit agar kunci enkripsi tidak bocor ke publik.