Network & VPN Issues

Troubleshooting connectivity problems with your POS server and remote access VPN.

POS Working Offline

Moneta Pay POS is designed to work without internet. Orders, printing, and cash payments continue normally. However, these features require connectivity:

• M-PESA reconciliation — payments queue and reconcile when online
• ESD fiscal submission — invoices queue and submit when online
• Remote dashboard access — requires VPN connection
• License validation — the server caches the license locally, so short outages are fine

VPN Not Connecting

If you can't access your POS remotely:

1. Check the VPN service on the POS server:

   sudo systemctl status wg-quick@wg0

2. Verify the tunnel is up:

   sudo wg show wg0

   You should see the nexus peer with a recent handshake timestamp
3. Check your device's VPN config — ensure you have the correct WireGuard configuration file installed
4. Firewall — UDP port 51820 must be open on your router for outbound traffic

DNS Not Resolving

If *.wg.moneta-pay.app addresses don't resolve:

• The private DNS server runs on the VPN at 10.100.0.1
• Ensure your VPN config sets DNS to 10.100.0.1
• Try accessing the POS by IP address directly (e.g., 10.100.0.33)

Slow Connection

• Check your internet speed — the POS dashboard requires minimal bandwidth
• WireGuard adds very little overhead
• If the dashboard loads slowly, the bottleneck is likely the POS server's internet connection, not the VPN

Contact Support

For persistent network or VPN issues, contact our support team. We can check the VPN hub status and verify your tunnel configuration remotely.