PPP Profiles

Overview

PPP Profiles are MikroTik PPP (Point-to-Point Protocol) profile definitions that control the connection parameters for PPPoE customers. Each profile is created and managed through ISPBills, which then synchronises the profile to the MikroTik router via the RouterOS API.

By managing PPP profiles through ISPBills — rather than directly in MikroTik Winbox or terminal — you ensure that:

  • Profile settings are consistent across ISPBills and the router.
  • Changes are tracked and applied automatically.
  • IP pool assignments and RADIUS settings remain in sync.
  • Misconfigurations caused by manual edits on the router are avoided.

Important: Always create and modify PPP profiles from ISPBills, not directly in MikroTik RouterOS. Direct changes on the router may be overwritten and will not be reflected in ISPBills.

Profile Fields

Profile Name

The identifier used both in ISPBills and on the MikroTik router. This name must match exactly between the two systems. ISPBills automatically pushes the correct name when syncing.

Examples: pppoe-default, pppoe-fiber, pppoe-reseller-zone1

IP Pool

The IPv4 pool from which customers using this profile will receive their IP address. Select from the pools defined in Routers & Packages > IPv4 Pools.

Changing the IP pool here automatically updates the profile on the router. Do not change the IP pool directly in MikroTik RouterOS.

Session Timeout

The maximum duration for a single PPPoE session. After this time, the session is forcibly terminated and the customer must reconnect. Leave blank for no session time limit.

Format: seconds (e.g., 86400 for 24 hours) or MikroTik time string (e.g., 1d).

Idle Timeout

How long an idle session (no data transfer) is kept open before being disconnected. Leave blank to keep idle sessions open indefinitely.

Local Address

The IP address the MikroTik router presents as the gateway for customers on this profile. This is typically the router's LAN-facing IP (e.g., 10.0.0.1). If left blank, MikroTik uses its default local address.

DNS Servers

The DNS server IP addresses assigned to customers when they connect using this profile. You can specify primary and secondary DNS servers (e.g., 8.8.8.8, 8.8.4.4).

Creating a PPP Profile

  1. Navigate to Routers & Packages > PPP Profiles.
  2. Click "New Profile".
  3. Enter the Profile Name.
  4. Select the IP Pool to assign to this profile.
  5. Configure Session Timeout, Idle Timeout, Local Address, and DNS Servers as needed.
  6. Click Save.

ISPBills will immediately push the profile to the linked MikroTik router via the RouterOS API.

Profile Sync to MikroTik

When a PPP profile is created or updated in ISPBills, the system automatically:

  1. Connects to the router via the RouterOS API.
  2. Creates or updates the PPP profile on the router with the defined parameters.
  3. Logs the synchronisation action in the activity log.

If the router is offline at the time of the change, the sync will be retried when the router comes back online.

Assigning a Profile to a Master Package

PPP profiles are assigned to Master Packages. When a customer activates a package, they are placed on the PPP profile specified in that package's master package definition.

To assign a profile:

  1. Go to Routers & Packages > Master Packages.
  2. Edit the relevant master package.
  3. Select the desired PPPoE Profile from the dropdown.

Replacing a Profile (Migrating Customers)

If you need to migrate customers from one PPP profile to another (e.g., moving to a new IP pool):

  1. Create the new PPP profile in ISPBills.
  2. Update the master package(s) to reference the new profile.
  3. Existing active sessions will migrate to the new profile upon their next reconnection.
  4. To force immediate migration, disconnect active sessions so they reconnect with the new profile.

Do not rename or delete profiles directly in MikroTik RouterOS. Use ISPBills to manage all profile changes.