Instalasi & Setup

Panduan ini menjelaskan cara menginstal dan mengkonfigurasi RetailOS di lingkungan Anda.

Persyaratan Sistem

Server Cloud Hub (Kantor Pusat)

Komponen	Minimum	Rekomendasi
CPU	4 core	8 core
RAM	8 GB	16 GB
Storage	100 GB SSD	500 GB SSD
OS	Ubuntu 22.04 LTS	Ubuntu 24.04 LTS
Database	PostgreSQL 15	PostgreSQL 16

Komputer Toko (Store Router + POS)

Komponen	Minimum	Rekomendasi
CPU	2 core	4 core
RAM	4 GB	8 GB
Storage	50 GB SSD	100 GB SSD
OS	Windows 10/11, macOS, Linux	Windows 11
Database	SQLite (otomatis)	SQLite (otomatis)

Perangkat Tambahan

• Printer Receipt - Thermal printer 80mm (Epson TM-T82, dll)
• Barcode Scanner - USB atau Bluetooth (mendukung EAN-13, Code 128)
• Cash Drawer - Terhubung via printer receipt
• RFID Reader - Opsional, untuk fitur RFID inventory

Instalasi Cloud Hub

1. Persiapan Server

# Update sistem
sudo apt update && sudo apt upgrade -y

# Install PostgreSQL
sudo apt install postgresql postgresql-contrib -y

# Buat database
sudo -u postgres createdb retailos_cloud
sudo -u postgres createuser retailos_app --pwprompt

2. Deploy dengan Docker

# Clone repository
git clone https://github.com/your-org/retailos.git
cd retailos

# Konfigurasi environment
cp deploy/.env.example deploy/.env
nano deploy/.env  # Edit sesuai kebutuhan

# Jalankan dengan Docker Compose
docker-compose up -d

3. Konfigurasi Environment

Edit file .env dengan pengaturan berikut:

Variable	Keterangan	Contoh
CLOUD_DB_URL	URL database PostgreSQL	postgres://retailos_app:pass@localhost/retailos_cloud
CLOUD_PORT	Port Cloud Hub	8080
JWT_SECRET	Secret key untuk token	your-secret-key-min-32-chars
TAILSCALE_AUTH_KEY	Key untuk VPN Tailscale	tskey-auth-xxxxx

4. Jalankan Migrasi Database

# Migrasi akan otomatis berjalan saat pertama kali start
# Atau jalankan manual:
./retailos-cloud migrate up

Instalasi Store Router

1. Download Installer

Download installer RetailOS Store dari portal admin atau server internal perusahaan.

2. Konfigurasi Toko

Buat file konfigurasi store.yaml:

store:
  id: "STORE-001"
  name: "Toko Retail Sudirman"
  cloud_url: "https://cloud.retailos.internal"

database:
  path: "./store.db"

sync:
  interval: 30  # detik

printer:
  type: "thermal"
  port: "USB001"

3. Jalankan Store Router

./retailos-store --config store.yaml

Instalasi POS Electron

1. Download Aplikasi POS

Download file installer POS sesuai sistem operasi:

• Windows: RetailOS-POS-Setup.exe
• macOS: RetailOS-POS.dmg
• Linux: RetailOS-POS.AppImage

2. Konfigurasi Koneksi

Saat pertama kali dibuka, POS akan meminta:

1. Store Router URL - Alamat Store Router lokal (contoh: http://localhost:8081)
2. Store ID - Kode toko (contoh: STORE-001)

3. Login Pertama Kali

Gunakan akun default admin yang sudah dibuat di Cloud Hub untuk login pertama kali.

Setup Jaringan

Arsitektur Jaringan Toko

Internet
    │
    ├── Tailscale VPN ──── Cloud Hub (Kantor Pusat)
    │
Toko LAN
    │
    ├── Store Router (PC Server Toko)
    │     ├── POS Kasir 1
    │     ├── POS Kasir 2
    │     └── POS Kasir 3
    │
    ├── Printer Receipt (via USB/Network)
    ├── Barcode Scanner (via USB)
    └── RFID Reader (via USB) [opsional]

Tips

Gunakan Tailscale untuk koneksi VPN yang aman antara toko dan kantor pusat. Tidak perlu konfigurasi port forwarding yang rumit.

Catatan

Store Router bisa berjalan di komputer yang sama dengan POS untuk toko kecil dengan 1 kasir.

Verifikasi Instalasi

Setelah instalasi selesai, verifikasi dengan langkah berikut:

1. Buka browser, akses http://localhost:8081/health - harus menampilkan status OK
2. Buka aplikasi POS - harus bisa login
3. Cek sinkronisasi - data master harus tersedia di POS
4. Test print - cetak struk test dari menu Settings

Troubleshooting Instalasi

Masalah	Solusi
POS tidak bisa konek ke Store Router	Pastikan Store Router sudah berjalan dan URL benar
Database error	Pastikan PostgreSQL sudah berjalan dan kredensial benar
Printer tidak terdeteksi	Cek koneksi USB dan install driver printer
Sync gagal	Cek koneksi internet dan Tailscale VPN

Halaman Terkait

• Hal Pertama yang Harus Dilakukan
• Panduan POS