Master Packages
Overview
A Master Package is the technical template that defines the network Quality of Service (QoS) parameters for an internet service tier. It specifies everything the network needs to know about how to provision a customer's connection: speed limits, data caps, session timeouts, IP pools, and PPPoE profile assignments.
Master Package vs. Package
| Master Package | Package | |
|---|---|---|
| Purpose | Technical specification (network parameters) | Pricing and presentation layer |
| Contains | Speed, volume, type, pool, profile | Name, customer price, operator price, visibility |
| Created by | Admin only | Admin |
| Reusability | One master package → many packages with different names/prices | Each package uses exactly one master package |
The same master package can underpin multiple packages sold at different price points or under different names to different resellers.
Master Package Fields
Name
Internal identifier for the master package (e.g., "10Mbps-PPPoE-Daily", "50Mbps-Monthly-Business"). Not shown to end customers directly.
Customer Type
| Type | Description |
|---|---|
| PPPoE | Customers authenticate via PPPoE (RADIUS username/password) |
| Hotspot | Customers authenticate via MikroTik Hotspot (browser redirect) |
| Static IP | Customers are assigned a fixed IP address |
| Other | Non-MikroTik managed connections (FTTH ONU, etc.) |
Billing Type
| Type | Description |
|---|---|
| Daily | Prepaid/recharge model — the package is valid for a specified number of days after activation |
| Monthly | Invoice-based — the customer is billed monthly; ISPBills generates invoices automatically |
Speed Limit
Upload and download rates assigned to customers on this package. Can be specified in Kbps or Mbps.
- Download Limit — maximum downstream bandwidth for the customer.
- Upload Limit — maximum upstream bandwidth for the customer.
Speed Controller
Determines where the speed limit is enforced:
| Controller | Description |
|---|---|
| Router | Speed limit is applied as a MikroTik Simple Queue or PCQ queue on the router |
| RADIUS Server | Speed limit is delivered via RADIUS attributes (e.g., Mikrotik-Rate-Limit) during authentication |
Important: For Hotspot packages, the Speed Controller must be set to RADIUS Server. For PPPoE packages, either controller can be used, but RADIUS Server is recommended for centralized management.
Volume Limit
An optional data cap for the package (e.g., 50 GB/month). When the customer exhausts their volume allowance, their session can be suspended or speed-throttled depending on configuration.
Leave blank for unlimited data packages.
Time Limit
An optional session time limit (in hours). The customer's session is automatically disconnected after this duration. Leave blank for no time restriction.
Burst Speed
MikroTik's Burst feature allows customers to briefly exceed their normal speed limit for short periods (useful for fast page loads while maintaining a lower sustained rate).
| Field | Description |
|---|---|
| Burst Download | Maximum burst download speed |
| Burst Upload | Maximum burst upload speed |
| Burst Threshold | When average speed drops below this value, burst is allowed |
| Burst Time | Duration (in seconds) that burst is sustained |
Leave burst fields blank to disable burst speed.
IP Pool
Select the IPv4 pool from which customer IP addresses will be assigned when they connect. IP pools are managed under Routers & Packages > IPv4 Pools.
PPPoE Profile
Select the MikroTik PPPoE profile to associate with this master package. PPPoE profiles define additional connection parameters (DNS, local address, session timeouts). Profiles are managed under Routers & Packages > PPP Profiles.
Creating a Master Package
- Navigate to Routers & Packages > Master Packages.
- Click "New Master Package".
- Fill in all relevant fields as described above.
- Click Save.
The master package is now available to assign to packages (in Your Packages) or to assign directly to operators/resellers with custom pricing.
Assigning a Master Package to Operators
When assigning a master package to a reseller, you must specify:
- The package name the reseller will use.
- The customer price (what the reseller's customers pay).
- The operator price (what the reseller pays to activate the package).
This allows the same master package (same technical specs) to be sold at different price points across your reseller network.
Navigate to Resellers & Managers > Resellers and edit the package list for each reseller.
Editing Master Packages
When you edit a master package's technical parameters (speed limits, pool, profile), the changes take effect for new connections and session renewals. Active sessions may retain old parameters until they reconnect or are refreshed via a RADIUS CoA (Change of Authorization) command.
Best practice: After changing speed parameters on a master package, use the Disconnect or Re-authorize action on active customers if you need the new speeds to apply immediately.