Skip to main content

Installation and Configuration

Prerequisites​

  • Internet for first activation and updates; offline selling works after activation
  • Receipt printer (USB/LAN/Bluetooth), barcode scanner (USB/Bluetooth), and cash drawer (if used)
  • Admin credentials provided by your organization

Install on Android (tablet/handheld)​

  1. Obtain the signed APK from your administrator or managed store.
  2. On the device, enable install from trusted sources if prompted.
  3. Install the APK, then allow camera (for barcode scan) and storage permissions when asked.
  4. Pair Bluetooth peripherals (scanner/printer) before first use if applicable.

Install on Linux (desktop/laptop)​

  1. Download the provided .deb or AppImage build.
  2. For .deb: sudo dpkg -i yegnapos_<version>.deb && sudo apt -f install
  3. For AppImage: ensure chmod +x YegnaPOS-<version>.AppImage and run it directly.
  4. Connect USB/Ethernet printers and scanners; verify they appear with lsusb or your distro’s printer settings.

Install on Windows (10/11)​

  1. Run the YegnaPOS-Setup-<version>.exe installer.
  2. Approve the Windows SmartScreen prompt and allow network access for local printing/sync.
  3. Install printer drivers (Epson/Star or vendor-specific) and pair USB/Bluetooth scanners.
  4. Pin the app to Start/Taskbar for quick access.

First-time configuration​

  1. Sign in with the admin account provided by your organization.
  2. Set company profile: legal name, TIN, address, contact, and receipt footer.
  3. Set currency to ETB and confirm VAT (commonly 15%) in tax settings.
  4. Add store/branch, default warehouse/location, and timezone.
  5. Configure payment methods (cash, card, mobile money, bank transfer) and map printer for receipts.
  6. Create roles (cashier/supervisor/manager) and assign user accounts; enforce PIN or strong passwords.

Hardware setup tips​

  • Receipt printers: prefer Ethernet/USB for stability; for Bluetooth, ensure the printer is paired before opening the app.
  • Cash drawer: connect through the receipt printer’s RJ12 port and enable “kick drawer on cash payments.”
  • Barcode scanners: set them to “keyboard wedge” mode so scanned codes type directly into the item search field.
  • Network: keep devices on the same LAN as printers for fastest printing; use static IPs for LAN printers where possible.