Common Issues
Quick solutions to the most frequently encountered problems.
"License expired" or "License invalid"
- Check that your license file is at
/etc/moneta_pay/license.json - Verify the license hasn't expired in the Portal
- If you have a card subscription, check that the last payment went through
- Contact support if the hardware ID has changed (e.g., after a hardware replacement)
"Maximum waiters reached"
Your license limits how many active waiters you can have. To add more:
- Deactivate a waiter you no longer need, or
- Upgrade to a higher plan in the Portal
Orders not printing
- Check that the printer is powered on and connected to the network
- Verify the printer IP and port in Settings > Printers
- Try a test print from the printer settings page
- See Printer Problems for detailed troubleshooting
M-PESA payments not reconciling
- Ensure the M-PESA add-on is enabled on your license
- Check your internet connection — payments reconcile when connectivity is available
- Unmatched payments appear in the dashboard for manual assignment
- Verify the till number matches your KopoKopo configuration
Dashboard not loading
- The dashboard runs on your local network — make sure you're connected
- Try accessing
http://<server-ip>:3000directly - If accessing remotely, ensure the VPN add-on is set up
- Check that the dashboard service is running:
sudo systemctl status moneta-pos-dashboard
POS running slowly
- Check that the server meets minimum requirements (4GB RAM, modern CPU)
- Large order histories can slow down searches — archive old data periodically
- Ensure the PostgreSQL database has sufficient disk space