Add a New Customer
You can add customers one at a time using the Add Customer form. To bulk-import many customers at once, see Import Customers.
Navigate to: Sidebar → Users → Add Customer
Step 1 — Connection Type
The first thing you select is the Connection Type. This determines what fields appear next.
| Option | Use when |
|---|
| PPPoE | Customer connects via router username/password |
| Hotspot | Customer connects through a captive portal |
| Static | Customer needs a fixed, dedicated IP address |
Step 2 — Select a Plan
After choosing the connection type, select an Internet Plan from the dropdown. Only plans matching the connection type you selected are shown.
If no plans appear, you need to first create a plan under Internet Plans. See Creating Plans.
Step 3 — Network Address & IP (PPPoE / Static only)
For PPPoE and Static customers, you will see a Network Address selector after picking a plan.
- Network Address — select the IP block (subnet) that belongs to the plan’s pool. If the plan only has one pool, it auto-selects.
- IP Address — pick an available IP from the block.
- For large blocks (e.g.,/16, /18): type a prefix in the search box (e.g.
10.0.3) and the matching available IPs appear. Click one to select it.
- For small blocks (e.g.,/24, /28): a dropdown lists all available IPs directly.
Step 4 — Customer Details
Fill in the customer’s personal information:
| Field | Required | Notes |
|---|
| Full Name | Yes | Customer’s full name |
| Phone Number | Yes | Used for SMS notifications and M-Pesa payments |
| Email | No | Optional contact email |
| Username | Yes | Login username (auto-generated or manual). For PPPoE this is the router login. |
| Password | Yes | Auto-generated by default. Click the eye icon to reveal it. |
Auto-Generate Username
Click Generate Username to let the system create a unique username based on the customer’s phone number or name.
Additional Account Number
Toggle Add Additional Account Number if the customer uses a separate account reference (e.g. a different M-Pesa paybill account number). Click Generate to auto-create one.
Step 5 — Payment & Activation
Payment Method
Choose how the customer is paying at the time of registration:
| Method | When to use |
|---|
| Cash | The customer paid cash in hand |
| M-Pesa | The customer sent money via M-Pesa |
| Bank | Payment received via bank transfer |
| Cheque | Payment by cheque |
Installation Fee
Toggle Charge Installation Fee if a one-time setup fee applies. Enter the amount in the field that appears.
Custom Amount
Toggle Charge Custom Amount to override the plan’s normal price for this specific registration. Useful for prorated or discounted first payments.
Auto Activate
| Setting | Effect |
|---|
| Yes | Customer is activated immediately on the router upon saving |
| No | Customer record is created but not provisioned on the router yet |
Step 6 — Save
Click Add Customer to create the account. On success you will be redirected to the customer’s detail page.
After saving, you can send the customer their login details via SMS directly from the customer detail page using Send Payment Details.
Common Errors
| Error | Fix |
|---|
| ”Name, price, speed and validity are required” | Check the selected plan has all fields filled |
| ”IP address is required” | Select an available IP from the IP picker |
| ”No plans appear” | Create a plan first under Internet Plans |
| ”Username already exists” | Use Generate Username or enter a different one |
