System Requirements

What you need before setting up Qserve Billing.

MikroTik Router

Qserve Billing connects to your MikroTik routers to provision and manage subscriber access. Requirements:

RequirementDetails
HardwareAny MikroTik RouterBOARD, hAP, CCR, RB series, or CHR (Cloud Hosted Router)
RouterOS Version6.45 or newer · RouterOS 7.x fully supported
Internet AccessRouter must be able to reach qserve-isp.net on port 443 (HTTPS) and port 13231 (WireGuard UDP)
WireGuard supportRequired for RouterOS 7.x. For 6.x, OpenVPN is used if WireGuard is unavailable.
Terminal accessWinBox, SSH, or Telnet to run the setup script

Network Requirements

Your router needs outbound access to the following:

  • qserve-isp.net — Port 443 (HTTPS) for API communication
  • qserve-isp.net — Port 13231 (UDP) for WireGuard VPN tunnel
  • ip-api.com — Port 443 (used by setup scripts for geo-detection, optional)

No inbound ports need to be opened on your router firewall. The VPN connection is outbound-initiated.

If your router is behind a strict firewall or carrier-grade NAT, ask your upstream ISP to allow outbound UDP on port 13231.

M-Pesa Payments (Optional)

To accept M-Pesa STK push payments, you need:

  • A registered Safaricom M-Pesa business (Pay Bill or Till number)
  • Access to Safaricom Daraja API — consumer key and secret
  • Your callback URL configured to https://qserve-isp.net/api/mpesa/callback

SMS / WhatsApp Notifications (Optional)

  • SMS: An AfricasTalking or compatible SMS gateway account with an API key
  • WhatsApp: A Meta Business account with a verified WhatsApp Business phone number and access token

Browser Requirements

The Qserve dashboard works on any modern browser:

  • Google Chrome 90+
  • Mozilla Firefox 88+
  • Microsoft Edge 90+
  • Safari 14+ (macOS/iOS)

JavaScript must be enabled. The dashboard is mobile-responsive and works on tablets and phones.

No Server Required

Qserve Billing is a fully hosted cloud service. You do not need to run your own server, install any software, or maintain a database. Everything runs on Qserve's infrastructure. Your MikroTik routers connect to the platform over the VPN tunnel — that is the only infrastructure you manage.