Cara Instal MAXsi POS Desktop di Windows, Ubuntu, Linux Mint, dan CachyOS

Panduan ini menjelaskan cara mengunduh, memasang, memperbarui, dan menghapus MAXsi POS Desktop pada Windows 64-bit serta Linux 64-bit. Untuk Linux tersedia pilihan repositori APT, paket DEB, dan AppImage.

Penting: aplikasi native desktop saat ini khusus untuk transaksi POS/kasir. Owner, admin, dan petugas gudang dapat menggunakan website MAXsi POS atau aplikasi Android. Modul native desktop lainnya dapat dikembangkan kemudian jika memang diperlukan.

Sebelum Memulai

Siapkan hal-hal berikut:

Daftar Isi

Komputer atau laptop dengan sistem operasi 64-bit.
Koneksi internet untuk login, sinkronisasi data, dan mengunduh pembaruan.
Akun MAXsi POS yang aktif.
Hak administrator apabila sistem meminta izin instalasi.
Installer hanya dari halaman download resmi MAXsi POS Desktop.

Pilihan paket yang tersedia:

Sistem operasi	Paket yang disarankan	Pembaruan
Windows 64-bit	Installer `.exe`	Auto update melalui updater MAXsi POS
Ubuntu/Linux Mint 64-bit	Repositori APT	Update Manager atau `apt upgrade`
Ubuntu/Linux Mint 64-bit	Paket `.deb`	Unduh versi baru secara manual
CachyOS/Arch Linux 64-bit	AppImage	Updater bawaan MAXsi POS

Instalasi di Windows 64-bit

1. Download installer Windows

Buka halaman download MAXsi POS Desktop.
Tekan Windows 64-bit.
Tunggu file installer dengan ekstensi .exe selesai diunduh.
Jangan memakai installer yang dikirim ulang oleh sumber yang tidak dikenal.

2. Jalankan installer

Buka folder Downloads di Windows.
Klik dua kali installer MAXsi POS.
Jika muncul permintaan User Account Control, periksa bahwa aplikasi yang dijalankan adalah MAXsi POS, lalu pilih Yes.
Ikuti proses instalasi sampai selesai.
Jalankan MAXsi POS dari Start Menu atau shortcut yang tersedia.

Jika Windows SmartScreen menampilkan peringatan, pastikan file berasal dari halaman resmi MAXsi. Periksa kembali nama aplikasi dan sumber unduhannya sebelum memilih tindakan lanjutan.

3. Auto update di Windows

Versi Windows mendukung auto update melalui updater bawaan MAXsi POS. Ketika rilis baru tersedia, aplikasi dapat mengunduh dan memasang pembaruan resmi tanpa pengguna harus mencari installer baru secara manual.

Saat proses pembaruan:

Selesaikan atau simpan transaksi yang sedang dikerjakan.
Izinkan aplikasi mengunduh pembaruan.
Tutup atau mulai ulang aplikasi apabila diminta.
Jangan mematikan komputer ketika pembaruan sedang dipasang.

Instalasi di Ubuntu dan Linux Mint melalui APT

Metode APT paling disarankan untuk Ubuntu dan Linux Mint karena versi baru dapat diterima melalui Update Manager atau perintah apt upgrade.

1. Tambahkan kunci repositori MAXsi POS

Buka Terminal, lalu jalankan:

curl -fsSL https://toko.maxsi.id/apt/maxsi-pos-archive-keyring.gpg \
  | sudo tee /usr/share/keyrings/maxsi-pos-archive-keyring.gpg >/dev/null

2. Tambahkan repositori resmi

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/maxsi-pos-archive-keyring.gpg] https://toko.maxsi.id/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/maxsi-pos.list

3. Perbarui daftar paket dan instal aplikasi

sudo apt update
sudo apt install ma-xsi-pos

Setelah selesai, cari MAXsi POS melalui menu aplikasi Ubuntu atau Linux Mint.

4. Memperbarui versi APT

Pembaruan dapat dipasang melalui Update Manager atau Terminal:

sudo apt update
sudo apt upgrade

Untuk memperbarui MAXsi POS saja:

sudo apt install --only-upgrade ma-xsi-pos

Alternatif Ubuntu/Linux Mint dengan Paket DEB

Gunakan paket DEB jika tidak ingin menambahkan repositori APT.

Buka halaman download resmi.
Tekan Linux Mint / Ubuntu (.deb).
Setelah file selesai diunduh, buka Terminal pada folder Downloads.
Jalankan perintah berikut dengan menyesuaikan nama file:

cd ~/Downloads
sudo apt install ./MAXsi\ POS_*_amd64.deb

Penggunaan apt install lebih disarankan daripada dpkg -i karena APT dapat membantu memasang dependency yang diperlukan.

Paket DEB yang diunduh manual tidak mengikuti repositori APT. Untuk mendapatkan versi berikutnya, unduh paket DEB terbaru dan jalankan kembali perintah instalasi.

Instalasi di CachyOS atau Arch Linux dengan AppImage

AppImage dapat dijalankan tanpa memasang paket MAXsi POS ke seluruh sistem.

1. Download AppImage

Buka halaman download MAXsi POS Desktop.
Tekan Arch / CachyOS AppImage.
Simpan file .AppImage, misalnya di folder ~/Applications.

Buat folder aplikasi jika belum ada:

mkdir -p ~/Applications

Pindahkan file yang telah diunduh:

mv ~/Downloads/MAXsi\ POS_*.AppImage ~/Applications/

2. Berikan izin eksekusi

chmod +x ~/Applications/MAXsi\ POS_*.AppImage

3. Jalankan MAXsi POS

~/Applications/MAXsi\ POS_*.AppImage

Anda juga dapat membuka file manager, klik kanan file AppImage, buka Properties/Permissions, lalu aktifkan izin untuk menjalankan file sebagai program.

Jika AppImage tidak dapat dibuka

Sebagian instalasi Arch Linux atau CachyOS mungkin memerlukan FUSE 2. Pasang hanya jika terminal menampilkan kesalahan terkait FUSE:

sudo pacman -S fuse2

Setelah itu, jalankan kembali AppImage. Jangan mengekstrak isi AppImage kecuali diperlukan untuk troubleshooting lanjutan.

Pembaruan AppImage

MAXsi POS AppImage mendukung pemeriksaan pembaruan melalui updater bawaan aplikasi. Pastikan file berada pada lokasi yang dapat ditulis oleh akun pengguna dan jangan memindahkan atau menghapus AppImage ketika proses pembaruan berlangsung.

Setelah MAXsi POS berhasil dibuka:

Masukkan domain atau identitas toko jika diminta.
Masukkan akun pengguna MAXsi POS.
Pilih konfigurasi kasir dan gudang yang digunakan untuk transaksi.
Buka register kasir sebelum menerima pembayaran.
Periksa printer, cash drawer, dan barcode scanner jika perangkat tersebut digunakan.

Versi native desktop difokuskan untuk POS/kasir. Gunakan website atau aplikasi Android untuk pekerjaan owner, admin, gudang, laporan lengkap, dan pengelolaan usaha lainnya.

Hotkey Penting Setelah Instalasi

Seluruh tombol utama POS mendukung hotkey keyboard. Beberapa shortcut yang tersedia:

F1: cari produk atau scan barcode.
F2: cari atau pilih ulang pelanggan.
F3: buka daftar produk.
F4: buka daftar penjualan.
F5: koreksi cart.
F6: edit item aktif.
F7: hold transaksi.
F8: buka open orders.
F9: tambah pengeluaran.
F10: buka pembayaran.
F11: buka register kasir.
Ctrl+F11: masuk atau keluar dari fullscreen.
F12: buka pengaturan POS.
Ctrl + + atau -: ubah jumlah item aktif.
Ctrl+Delete: kosongkan cart.
Tombol panah dan Enter: navigasi serta memilih item.
Esc: tutup panel atau dialog.

Pada halaman pembayaran tersedia pula quick cash dengan Alt+1 sampai Alt+9, reset dengan Alt+0, tambah pembayaran dengan Alt+A, dan proses pembayaran dengan Ctrl+Enter.

Memilih Tema Terang atau Gelap

MAXsi POS Desktop menyediakan tiga pilihan tampilan:

Terang untuk lingkungan dengan pencahayaan kuat.
Gelap agar layar lebih nyaman pada ruangan redup.
Ikuti sistem untuk menyesuaikan tema Windows atau Linux secara otomatis.

Pilihan tema tidak mengubah data transaksi maupun fungsi kasir.

Troubleshooting Umum

Pastikan koneksi internet aktif.
Periksa domain toko, nama pengguna, dan kata sandi.
Pastikan akun memiliki izin menggunakan POS/kasir.
Tutup aplikasi, buka kembali, lalu coba login ulang.

Barcode scanner tidak memasukkan kode

Pastikan scanner terdeteksi sebagai perangkat keyboard.
Arahkan fokus ke kolom pencarian produk dengan F1.
Periksa pengaturan suffix scanner. Umumnya scanner mengirim tombol Enter setelah barcode.

Printer atau cash drawer tidak merespons

Periksa kabel data dan daya printer.
Pastikan printer yang benar telah dipilih pada pengaturan POS.
Periksa lebar kertas dan konfigurasi ESC/POS.
Cash drawer umumnya terhubung melalui port printer kasir, bukan langsung ke komputer.

AppImage dapat tetap dijalankan langsung dari folder ~/Applications. Untuk paket APT atau DEB, logout dan login kembali jika menu aplikasi belum menyegarkan shortcut.

Pembaruan gagal

Pastikan transaksi telah diselesaikan dan aplikasi memiliki izin menulis file.
Pastikan koneksi internet stabil.
Buka kembali aplikasi dan ulangi pembaruan.
Jika tetap gagal, unduh installer terbaru dari halaman resmi dan pasang kembali tanpa menghapus data akun.

Cara Menghapus MAXsi POS Desktop

Windows

Buka Settings.
Masuk ke Apps > Installed apps.
Cari MAXsi POS.
Pilih Uninstall dan ikuti petunjuk.

Ubuntu/Linux Mint melalui APT atau DEB

sudo apt remove ma-xsi-pos

Jika tidak ingin menggunakan repositori MAXsi lagi:

sudo rm /etc/apt/sources.list.d/maxsi-pos.list
sudo rm /usr/share/keyrings/maxsi-pos-archive-keyring.gpg
sudo apt update

CachyOS/Arch Linux AppImage

Tutup MAXsi POS, lalu hapus file AppImage dari folder tempat Anda menyimpannya. Karena AppImage bersifat portabel, tidak diperlukan perintah uninstall paket.

Unduhan dan Informasi Resmi

Selalu gunakan installer resmi agar aplikasi menerima pembaruan yang sesuai dan paket dapat diverifikasi oleh sistem updater MAXsi POS.