Getting StartedOperator runbook

Getting Started

Step-by-step guide to configure ISPbills — from registration to a tested customer connection

Get help
What this guide covers

Step-by-step guide to configure ISPbills — from registration to a tested customer connection

On this page

Self-hosting operators should complete the onboarding checklist provided by ISPbills support before adding production customers.

Welcome to ISPbills! This guide walks you through the essential steps to go from a verified account to a tested customer connection. Configuration uses the normal menus; there is no separate first-login setup wizard.

Estimated setup time: 30–60 minutes for a basic configuration with one router and a few packages.

Before You Begin

Make sure you have the following ready:

  • A MikroTik router with RouterOS 6.x or 7.x and the API service enabled
  • The router’s public IP address (or a VPN if the router is behind NAT)
  • The router’s API credentials (username and password)
  • Your ISP’s business name, address, and contact details
  • (Optional) SMS gateway credentials if you want to send notifications

See Prerequisite for detailed requirements.

Step 1 — Register Your Account

  1. Go to app.ispbills.com/register.
  2. Enter your business email, full name, company, mobile number with country code, and country.
  3. Create and confirm a password of at least 12 characters containing a number, an uppercase letter, and a special character.
  4. Choose email-link or mobile-code verification, create the account, and finish verification.

See Demo and Registration for details.

Step 2 — Complete Your ISP Profile

  1. After verification, go to Settings → Profile Settings (shown as ISP Setup in the page sub-navigation).
  2. Enter your ISP’s business name, address, logo, and contact details.
  3. This information appears on invoices, the customer portal, and notifications.

See ISP Profile.

Step 3 — Add Your First Router

  1. Go to Network → Router.
  2. Click New Router.
  3. Enter the location, IP address, API port, API user, API password, required map coordinates, and the PPP comment preference.
  4. Submit the form. ISPbills checks the connection while creating the router and reports a connection or permission error if it cannot continue.

If creation fails, confirm that the router API service is enabled, the address and port are reachable from the ISPbills server, and the API credentials and permissions are correct.

If your router is behind NAT (no public IP), you need to set up a VPN account first. See VPN Accounts.

See Routers for the full guide.

Step 4 — Create PPP Profiles and IP Pools

  1. Go to Network → IPv4 Pool, select New Pool, and create an address pool for your customers.
  2. Go to Network → PPP Profiles, select the create control, and create a PPP profile linked to the router and pool.

These profiles control the authentication and IP assignment for your PPPoE customers.

See IPv4 Pools and PPP Profiles.

Step 5 — Create Your First Package

  1. Go to Network → Package (the page sub-navigation labels this Own Packages).
  2. Click Add Package.
  3. Select the applicable master package and enter the customer/operator pricing and package options offered by the form.
  4. Submit the package.

See Your Packages.

Step 6 — Add Your First Customer

  1. Go to Customers → All Customers.
  2. Click New Customer.
  3. Complete the identity and required map fields, choose the connection type, and select Next.
  4. Complete the billing-profile, package, and technical-information steps, including the username and password when requested, then finish creation.

If the customer is not provisioned immediately, review the router connection, PPP profile, and package configuration before creating additional customer records.

The customer can now connect and authenticate.

See Customer Types and Actions.

Step 7 — Configure Billing

  1. Go to Network → Billing Profile to review or create the billing rules used by the customer workflow.
  2. Adjust grace periods, auto-suspension settings, and VAT as needed for your operation.

See Billing Profile.

Optional: Set Up Notifications

  • SMS: Go to Settings → SMS Gateway to configure your SMS provider, then enable event-based SMS under SMS & Notifications → Event SMS.
  • WhatsApp: See Integrations for WhatsApp notification setup.
  • Email: See Integrations for email notification setup.

Optional: Set Up Payment Gateways

Go to Settings → Payment Gateways to enable online payments (bKash, Nagad, SSL Commerz, etc.) so customers can pay through the customer portal.

See Payment Gateways.

What’s Next?

Now that you have a working setup, explore these sections to get the most out of ISPbills:

  • Dashboard — Monitor your ISP’s key metrics at a glance
  • NOC Panel — Dedicated workspace for NOC users with network monitoring, device management, and the iPilot AI terminal
  • NOC Dashboard — Real-time network operations view
  • Monitoring — Monitor routers, wireless devices, and fibre infrastructure
  • SMS and Notifications — Automate customer communication
  • Complaint Management — Track and resolve customer issues
  • Accounts — Financial reporting and reconciliation
  • Mobile App — Manage operations from your Android device
Need help applying this guide?Browse related guidance or ask the support team for help.