Quick Start

Get your ISP billing system running in under 30 minutes.

Step 1 — Register your ISP

Go to qserve-isp.net/register and fill in your ISP details. After submitting, the Qserve team reviews your application (usually within a few hours) and sends your login credentials by email.

Step 2 — Log in and complete setup

Open the link in your welcome email to set your password, then log in at qserve-isp.net/users/log-in. You will land on your tenant dashboard. Complete the initial setup steps shown on the dashboard banner.

Step 3 — Create your first Site

A Site represents a physical location where your MikroTik router is installed (e.g., "Nairobi HQ" or "Westlands Node").

1. Go to Sites in the left menu and click New Site.
2. Enter the site name and address, then save.
3. On the site page, click Add Router and fill in the router details (model, MAC address).
4. Save — Qserve generates a unique VPN config for that router.

Step 4 — Run the MikroTik setup script

This is the most important step. Qserve provides a one-line terminal command that auto-configures your MikroTik router.

1. On the Site page, open your router and click Install.
2. Copy the installation command shown on screen.
3. Open your MikroTik terminal (WinBox → Terminal, or SSH into the router).
4. Paste and run the command. It downloads and executes the setup script automatically.

/tool fetch url="https://qserve-isp.net/downloads/mikrotik/set-vpn/YOUR_ROUTER_ID" \
  dst-path=setup.rsc; /import setup.rsc

The script sets up the WireGuard VPN tunnel, configures PPPoE server profiles, and connects the router to Qserve. The whole process takes about 2 minutes.

Step 5 — Create a Plan

Plans define the internet service you sell — speed, duration, and price.

1. Go to Plans and click New Plan.
2. Set the name (e.g., "10 Mbps Monthly"), price (e.g., KES 1,500), duration (30 days), and upload/download speeds.
3. Select the service type: PPPoE, Hotspot, or Static.
4. Save the plan.

Step 6 — Add your first Subscriber

1. Go to Customers and click New Subscriber.
2. Enter name, phone number, email, and (for PPPoE) a username and password.
3. Assign a package (choose from your active plans).
4. Click Save & Activate — Qserve sends the credentials to your MikroTik router immediately.

Step 7 — Test the connection

Have the subscriber connect using their PPPoE credentials. Their router dials in, Qserve's RADIUS server authenticates them, and the connection is established. You can confirm this from Customers → [subscriber name] → Connection Status.