Instalasi

Hanya edisi Desktop dan Server yang memerlukan instalasi. Edisi Cloud tidak perlu setup — cukup daftar dan langsung masuk.

Persyaratan Sistem

Edisi Desktop

Edisi Server

Instalasi Desktop (Windows)

1. Unduh BasisSetup-v<versi>.exe dari halaman GitHub Releases.
2. Jalankan installer — tidak memerlukan hak administrator. Instalasi dilakukan per-pengguna.
3. Setujui lisensi, pilih apakah ingin membuat shortcut desktop, lalu klik Install.
4. Jalankan Basis Accounting dari Start menu atau shortcut desktop.
5. Saat pertama kali dibuka, wizard pengaturan memandu konfigurasi perusahaan pertama Anda.

Peringatan Windows SmartScreen: Saat pertama kali diunduh, Windows mungkin menampilkan "Windows protected your PC." Klik Informasi selengkapnya → Tetap jalankan jika Anda sudah memverifikasi checksum file. Lihat Verifikasi Unduhan.

Instalasi Server — Windows

Langkah 1 — Unduh dan ekstrak

Unduh BasisServer-v<versi>-win-x64.zip dari halaman GitHub Releases dan ekstrak ke folder permanen:

C:\Basis\

Folder harus berisi Basis.Web.exe dan file-file pendukung.

Langkah 2 — Konfigurasi

Ganti nama file template:

appsettings.Custom.json.template  →  appsettings.Custom.json

Edit appsettings.Custom.json:

{
  "Urls": "http://+:8080",
  "LicenseOptions": {
    "Edition": "Server",
    "Key": "KUNCI-LISENSI-ANDA"
  },
  "DatabaseOptions": {
    "BasePath": "C:\\BasisData"
  },
  "JwtSettings": {
    "SecretKey": "GANTI-DENGAN-STRING-ACAK-KUAT-MIN-32-KARAKTER",
    "Issuer": "Basis",
    "Audience": "BasisUsers"
  }
}

Buat folder data:

New-Item -ItemType Directory -Force -Path "C:\BasisData\businesses"
New-Item -ItemType Directory -Force -Path "C:\BasisData\attachments"

Langkah 3 — Uji secara manual

cd C:\Basis
.\Basis.Web.exe

Buka http://localhost:8080 di browser untuk memastikan aplikasi berjalan. Hentikan dengan Ctrl+C.

Langkah 4 — Pasang sebagai Windows Service (produksi)

Jalankan perintah berikut di PowerShell Administrator:

sc create "BasisServer" `
  binPath= "C:\Basis\Basis.Web.exe" `
  DisplayName= "Basis Accounting Server" `
  start= auto

sc start "BasisServer"

Manajemen service:

sc start   "BasisServer"
sc stop    "BasisServer"
sc delete  "BasisServer"   # hentikan dulu sebelum dihapus

Log: Event Viewer → Windows Logs → Application → Source: BasisServer

Langkah 5 — Firewall (jika diakses dari mesin lain)

New-NetFirewallRule -DisplayName "Basis Server" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow

Langkah 6 — Reverse proxy / HTTPS (opsional)

Tempatkan IIS atau nginx di depan Basis dan proxy semua traffic ke http://localhost:8080. Lihat file INSTALL.md yang disertakan dalam paket Server untuk contoh konfigurasi IIS web.config lengkap.

Instalasi Server — Linux (Ubuntu / Debian / Rocky)

Langkah 1 — Buat pengguna khusus

sudo useradd -r -s /bin/false basis

Langkah 2 — Ekstrak paket

sudo mkdir -p /opt/basis
sudo unzip BasisServer-v<versi>-linux-x64.zip -d /opt/basis
sudo chmod +x /opt/basis/Basis.Web
sudo chown -R basis:basis /opt/basis

Langkah 3 — Buat folder data

sudo mkdir -p /var/basis/data/businesses
sudo mkdir -p /var/basis/data/attachments
sudo chown -R basis:basis /var/basis

Langkah 4 — Konfigurasi

sudo cp /opt/basis/appsettings.Custom.json.template /opt/basis/appsettings.Custom.json
sudo nano /opt/basis/appsettings.Custom.json

Atur DatabaseOptions.BasePath ke /var/basis/data dan ganti JwtSettings.SecretKey dengan string acak yang kuat. Batasi izin file konfigurasi:

sudo chown basis:basis /opt/basis/appsettings.Custom.json
sudo chmod 640 /opt/basis/appsettings.Custom.json

Langkah 5 — Pasang sebagai systemd service

sudo cp /opt/basis/basis.service /etc/systemd/system/basis.service
sudo systemctl daemon-reload
sudo systemctl enable basis
sudo systemctl start basis

Cek status dan log:

sudo systemctl status basis
sudo journalctl -u basis -f

Langkah 6 — Firewall

# Ubuntu/Debian (ufw)
sudo ufw allow 8080/tcp

# Rocky/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload

Langkah 7 — Reverse proxy dengan nginx (disarankan untuk HTTPS)

Lihat file INSTALL.md yang disertakan dalam paket Server untuk konfigurasi nginx lengkap dengan SSL dan Let's Encrypt.

Referensi Konfigurasi

Field penting dalam appsettings.Custom.json:

Pembaruan

• Desktop — Jalankan installer baru di atas instalasi yang ada. Database tidak terpengaruh.
• Server (Windows) — Hentikan service, ganti semua file di C:\Basis\ (pertahankan appsettings.Custom.json), mulai ulang service.
• Server (Linux) — Hentikan service, ekstrak paket baru ke /opt/basis/, mulai ulang service.

Data di DatabaseOptions.BasePath tidak pernah diubah oleh pembaruan.

Terkait

• Verifikasi Unduhan
• Quick Start
• Migrasi Data