Logo Cafeku Cafeku
Panduan untuk Pemula

Tutorial Setup Cafeku

Panduan ini dimulai dari instalasi resmi melalui Google Play, lalu setup aplikasi di satu perangkat, printer Bluetooth, dan troubleshooting. Bila Anda butuh beberapa perangkat sekaligus, ada bagian khusus tentang Cafeku Server Desktop dan Mode Client. Ikuti urutannya dari atas ke bawah agar langsung siap dipakai berjualan.

1 Install dari Google Play

Gunakan Play Store agar Anda mendapatkan aplikasi resmi dan pembaruan yang sesuai.

  • Buka halaman Cafeku di Google Play. Anda bisa mencarinya di Play Store atau membuka tautan: Cafeku di Google Play.
  • Tekan Install. Tunggu sampai proses download dan pemasangan selesai.
  • Pasang di setiap perangkat yang akan dipakai. Untuk pemakaian satu perangkat, cukup install di satu HP/tablet. Bila Anda memakai Cafeku Server Desktop, install aplikasi ini di semua HP/tablet kasir dan dapur yang akan menjadi client.
Catatan Play Store Jika Play Store menampilkan tombol update, lakukan update terlebih dahulu agar panduan ini cocok dengan versi aplikasi terbaru yang terpasang.

2 Sebelum mulai

Siapkan hal-hal berikut terlebih dahulu agar prosesnya lancar.

  • HP/Tablet Android. Untuk memakai Cafeku, satu perangkat sudah cukup dan semua fitur berjalan penuh di situ.
    Disarankan tablet agar layar kasir lebih luas.
  • Aplikasi Cafeku sudah terpasang dari Google Play di setiap perangkat yang akan dipakai.
  • Hanya bila ingin multi-perangkat: sebuah komputer (Windows, macOS, atau Linux) untuk menjalankan Cafeku Server Desktop, serta satu jaringan Wi-Fi yang sama untuk komputer dan semua perangkat client.
Istilah singkat Single device = aplikasi berdiri sendiri, semua data ada di HP/tablet itu. Client = aplikasi menyambung ke Cafeku Server Desktop yang berjalan di komputer. Aplikasi Android tidak bisa dijadikan server.

3 Memahami mode single device & Mode Client

Bagian ini cuma 1 menit, tapi penting supaya Anda tidak bingung.

Secara default Cafeku adalah software manajemen satu perangkat. Menu, stok, resep, transaksi, dan laporan semuanya tersimpan di HP/tablet tempat aplikasi dipasang. Tidak perlu jaringan, tidak perlu komputer, dan tidak ada mode server di dalam aplikasi.

Kalau cafe Anda butuh lebih dari satu perangkat — misalnya dua kasir plus layar dapur terpisah — servernya dijalankan dari software desktop, yaitu Cafeku Server Desktop di komputer Anda. Setelah server itu berjalan, aplikasi Android disambungkan sebagai Mode Client (POS atau Kitchen).

Aplikasi ini tidak punya mode server. Anda tidak akan menemukan tombol “Aktifkan Server” di aplikasi Android. Satu-satunya cara memakai banyak perangkat sekaligus adalah menjalankan Cafeku Server Desktop di komputer.
Cukup satu perangkat? Bisa, dan itu pemakaian yang paling umum. Satu perangkat saja sudah lengkap sebagai kasir + admin. Langsung lanjut ke langkah 4, lalu lompati langkah 6 sampai 8.

4 Setup awal aplikasi (single device)

Lakukan ini di perangkat yang akan dipakai berjualan.

  • Buka aplikasi Cafeku. Saat pertama kali, akan muncul layar Selamat datang di Cafeku.
  • Isi data cafe. Lengkapi Nama Cafe, Nama Owner, Mata Uang misalnya Rp, serta Pajak % dan Service % bila ada. Kalau belum tahu, biarkan pajak & service di angka 0 dulu.
  • Buat akun Superadmin. Isi Nama, Username, dan Password minimal 4 karakter. Catat dan simpan username & password ini karena akun ini memiliki akses penuh.
  • Aktifkan Isi data contoh. Biarkan opsi ini menyala agar aplikasi otomatis membuat contoh menu, stok, resep, serta akun kasir & chef demo. Ini membantu untuk belajar. Matikan bila ingin mulai dari data kosong.
  • Tekan Mulai. Aplikasi akan menyiapkan data di perangkat ini dan membawa Anda ke layar login.
  • Login. Masukkan Username & Password superadmin yang tadi dibuat, lalu tekan Masuk. Anda akan masuk ke Dashboard.
Selesai. Pada titik ini perangkat sudah siap dipakai sebagai kasir & admin mandiri. Menu di sebelah kiri seperti Dashboard, POS, Menu, Stok, Resep, Laporan, dan Backup sudah bisa dijelajahi — semuanya tanpa server.

5 Mengisi menu, stok & resep

Lewati bagian ini jika Anda memakai data contoh dan ingin langsung mencoba. Untuk data asli cafe Anda, ikuti urutan ini.

  • Buka menu Stok lalu tambahkan bahan baku seperti susu, gula, atau kopi beserta satuan, stok awal, dan harga modal.
  • Buka Menu lalu buat kategori seperti Coffee atau Food, kemudian tambahkan menu jual beserta harganya.
  • Buka Resep lalu pilih sebuah menu dan tentukan bahan apa saja yang dipakai serta takarannya. Aplikasi otomatis menghitung HPP dan margin.
Kenapa resep penting? Setiap kali menu terjual di POS, stok bahan akan berkurang otomatis sesuai resep. Tanpa resep, stok tidak ikut berkurang.

6 Cafeku Server Desktop (khusus multi-perangkat)

Langkah ini hanya perlu bila Anda ingin memakai beberapa perangkat sekaligus. Untuk pemakaian satu perangkat, lewati langkah 6 sampai 8 dan langsung ke printer Bluetooth.

Karena aplikasi Android tidak memiliki mode server, server dijalankan lewat Cafeku Server Desktop — satu file aplikasi untuk komputer yang tinggal di-double-click. Di sanalah database, API lokal, dan WebSocket berjalan, sehingga aplikasi Android (POS & Kitchen) dan Web Dashboard bisa menyambung.

  • Unduh sesuai sistem operasi. Buka halaman Download Server Desktop, lalu pilih Windows, macOS, atau Linux.
  • Jalankan servernya. Windows: double-click cafeku-server.exe. macOS: ekstrak ZIP lalu buka Cafeku Server.app (pertama kali, klik kanan → Open karena belum ditandatangani Apple). Linux: beri izin eksekusi lalu jalankan file cafeku-server-linux-amd64.
  • Pilih database (sekali saja). Saat pertama kali, browser otomatis terbuka ke halaman pengaturan. Pilih SQLite (tanpa setup, cocok untuk satu lokasi) atau MariaDB/MySQL (bila Anda sudah punya server database).
  • Isi data cafe & buat superadmin. Lengkapi nama cafe, mata uang, pajak/service, lalu buat akun Username & Password superadmin. Centang isi data contoh bila ingin langsung mencoba.
  • Catat alamat koneksi. Setelah selesai, jendela server menampilkan alamat seperti http://192.168.0.105:8080 (gabungan IP Address komputer dan Port 8080) dan panel admin terbuka otomatis di browser. Alamat inilah yang dimasukkan di setiap perangkat client.
Satu jaringan & tetap menyala. Komputer server dan semua perangkat client wajib berada di Wi-Fi/LAN yang sama. Biarkan jendela server tetap terbuka selama jam operasional. Untuk MariaDB/MySQL, buat database-nya dulu (mis. CREATE DATABASE cafeku;) — tabel dibuat otomatis.
Tips stabil: Gunakan alamat IP tetap atau DHCP reservation di router untuk komputer server agar alamatnya tidak berubah-ubah dan client tidak perlu disetel ulang.

7 Akses Web Dashboard Admin (dari browser)

Saat Server Desktop berjalan, Anda bisa mengelola cafe dari komputer atau laptop mana pun lewat browser, tanpa install apa pun. Cocok untuk mengelola stok & menu di layar besar.

  • Jalankan Cafeku Server Desktop di komputer (lihat langkah sebelumnya).
  • Sambungkan komputer/laptop ke Wi-Fi yang sama dengan komputer server. Bila Anda memakai komputer server itu sendiri, panel admin sudah terbuka otomatis.
  • Buka browser (Chrome, Edge, Safari, dan lainnya).
  • Ketik alamat server yang tampil di jendela server, contohnya http://192.168.0.105:8080, lalu tekan Enter.
  • Login menggunakan akun Admin atau Superadmin. Akun kasir/chef tidak bisa masuk ke panel web.

Di Web Dashboard Anda dapat:

  • Memantau real-time — total penjualan hari ini, jumlah transaksi, status server, menu terlaris, stok menipis, dan layar dapur (Kitchen) yang ter-update otomatis.
  • Kelola Menu — tambah/edit menu, kategori, serta set tersedia/habis.
  • Kelola Stok — tambah/edit bahan dan lakukan penyesuaian (pembelian, waste, dan lainnya).
  • Kelola Resep — atur bahan tiap menu, HPP dihitung otomatis.
  • Lihat Laporan — penjualan per metode bayar, per kasir, menu terlaris, bahan terbanyak dipakai, serta estimasi profit.
Tips: Simpan alamat (misalnya http://192.168.0.105:8080) sebagai bookmark di browser agar cepat dibuka. Web Dashboard hanya bisa diakses selama Server Desktop menyala dan berada di jaringan Wi-Fi yang sama.
Khusus admin. Web Dashboard ditujukan untuk pemilik/admin mengelola data. Transaksi kasir tetap dilakukan lewat aplikasi di perangkat POS.

8 Setup Mode Client (POS & Kitchen)

Lakukan ini di setiap perangkat kasir atau tablet dapur. Pastikan Cafeku Server Desktop sudah berjalan dari langkah 6.

  • Sambungkan perangkat client ke Wi-Fi yang sama dengan komputer server.
  • Buka aplikasi Cafeku di perangkat client yang sudah diinstal dari Google Play.
  • Pilih mode client. Di layar awal Setup atau Login, tekan Hubungkan sebagai Client.
    Di layar setup tombolnya tertulis: Atau hubungkan device ini sebagai Client.
  • Masukkan alamat server. Isi IP Server dan Port persis seperti yang tampil di jendela Cafeku Server Desktop.
  • Login dengan akun yang ada di server. Masukkan Username & Password, misalnya akun kasir untuk POS atau chef untuk dapur.
  • Tekan Hubungkan & Masuk.
  • Pilih tampilan. Jika peran Anda mengizinkan keduanya, akan ada tombol pindah POS / Kitchen di atas. Kasir otomatis ke POS, Chef otomatis ke Kitchen.
Apa bedanya di client? POS Client mengambil daftar menu dari server dan mengirim transaksi ke server. Kitchen Client menampilkan pesanan secara real-time dan bisa mengubah status masakan dari Baru, Dimasak, Siap, hingga Selesai.
Sekali sambung, tersimpan. Perangkat client akan mengingat koneksinya. Untuk berpindah server atau keluar, gunakan tombol logout di pojok kanan atas.

9 Menghubungkan printer Bluetooth (struk)

Untuk mencetak struk, gunakan printer thermal Bluetooth ESC/POS 58mm.

  • Nyalakan printer dan pastikan kertas tersedia.
  • Pairing dulu di Android. Buka Pengaturan Bluetooth bawaan HP/tablet, lalu sambungkan dengan printer Anda. Langkah ini di luar aplikasi Cafeku dan cukup dilakukan sekali.
  • Pilih printer di Cafeku. Buka Pengaturan bagian Printer, lalu tekan Atur Printer & Test Print. Izinkan akses Bluetooth bila diminta, lalu pilih printer Anda dari daftar.
    Bisa juga lewat ikon printer di pojok layar POS.
  • Tes. Tekan Test Print. Jika keluar struk tes, printer siap dipakai.
  • Cetak struk transaksi. Di POS, setelah pembayaran berhasil, pada layar struk tekan Cetak Struk.
Belum muncul printernya? Pastikan sudah di-pair lewat Pengaturan Bluetooth Android, printer menyala, dan izin Bluetooth sudah diberikan ke aplikasi.

10 Peran pengguna & akun demo

Setiap akun punya hak akses berbeda agar operasional tetap aman.

PeranAkses utama
SuperadminSemua fitur, pengaturan, backup/restore, dan kelola user.
AdminDashboard, menu, stok, resep, pembelian, laporan, dan kelola kasir/chef.
KasirPOS: buka shift, transaksi, pembayaran, dan cetak struk.
ChefKitchen Display: melihat dan mengubah status pesanan.

Jika Anda mengaktifkan Isi data contoh saat setup, tersedia akun demo berikut untuk mencoba, terutama saat login dari perangkat client:

AkunUsernamePassword
Kasir Demokasirkasir123
Chef Demochefchef123
Demi keamanan: Setelah selesai mencoba, ganti password akun demo atau nonaktifkan lewat menu User, dan buat akun kasir/chef asli untuk staf Anda.

11 Mengatasi masalah umum

Tekan salah satu pertanyaan untuk melihat jawabannya.

Play Store menampilkan aplikasi tidak tersedia

Pastikan akun Google dan perangkat Android Anda memenuhi persyaratan Play Store. Jika aplikasi baru saja dipublikasikan, tunggu propagasi listing atau coba perbarui Play Store.

Saya tidak menemukan menu Server di aplikasi

Memang tidak ada. Aplikasi Android Cafeku adalah software manajemen satu perangkat dan tidak memiliki mode server. Untuk memakai beberapa perangkat sekaligus, jalankan Cafeku Server Desktop di komputer, lalu sambungkan aplikasi sebagai Client.

Client tidak bisa terhubung ke server

Periksa berurutan: komputer server & perangkat client berada di Wi-Fi yang sama; jendela Cafeku Server Desktop masih terbuka dan servernya berjalan; IP & Port yang dimasukkan di client sama dengan yang tampil di jendela server; firewall komputer mengizinkan port 8080; dan jaringan tidak memblokir komunikasi antar-perangkat seperti pada beberapa Wi-Fi publik/hotel.

Alamat IP server berubah-ubah

IP bisa berubah saat komputer menyambung ulang ke Wi-Fi. Solusi: atur DHCP reservation atau IP tetap untuk komputer server di pengaturan router, lalu masukkan IP itu di client.

Username atau password salah saat login

Untuk pemakaian single device, gunakan akun yang dibuat di perangkat itu sendiri. Untuk client, akun harus ada di Server Desktop — misalnya kasir / chef atau akun lain yang dibuat admin lewat Web Dashboard.

Stok tidak berkurang setelah penjualan

Stok hanya berkurang jika menu memiliki resep. Buka menu Resep, pilih menu terkait, dan lengkapi bahan beserta takarannya.

Web Dashboard tidak bisa dibuka di browser

Pastikan Cafeku Server Desktop sedang berjalan, komputer berada di Wi-Fi yang sama, dan alamat diketik lengkap dengan http:// serta port-nya, contohnya http://192.168.0.105:8080. Login juga harus memakai akun Admin/Superadmin — akun kasir/chef akan ditolak.

Printer tidak ditemukan atau gagal cetak

Pair printer dulu di Pengaturan Bluetooth Android, nyalakan printer, cek kertas, beri izin Bluetooth ke aplikasi, lalu pilih printer di Pengaturan > Printer dan lakukan Test Print.

Koneksi client putus saat komputer tidur

Biarkan jendela Cafeku Server Desktop tetap terbuka selama jam operasional dan matikan mode sleep/hibernate di komputer server. Perangkat client akan menyambung ulang otomatis begitu server kembali aktif.

Bagaimana mengamankan data?

Lakukan backup berkala lewat menu Backup khusus superadmin, lalu simpan file backup di tempat aman. Restore juga dilakukan dari menu yang sama.

Masih butuh bantuan? Hubungi kami di cafeku@kiarumea.id.

Kembali ke Beranda