How to Connect a PPPoE Account

Follow the guide for your device type to configure your PPPoE credentials and get online.

MikroTik RouterOS – PPPoE Client Setup

Use the commands below via Winbox Terminal or SSH. Replace YOUR_USERNAME and YOUR_PASSWORD with the credentials from your customer account.

Option 1 – Via Terminal (CLI)

Connect via Winbox terminal or SSH and run:

/interface pppoe-client
add name=pppoe-out1 interface=ether1 \
    user=YOUR_USERNAME \
    password=YOUR_PASSWORD \
    service-name="" \
    disabled=no \
    add-default-route=yes

Verify the connection is up:

/interface pppoe-client print detail

The status field should show connected and you will see an assigned IP address.

Option 2 – Via Winbox GUI

Open Winbox and connect to your router.
Go to Interfaces → click the + button → select PPPoE Client.
On the General tab set Interface to the WAN port (usually ether1).
On the Dial Out tab enter:
- User: YOUR_USERNAME
- Password: YOUR_PASSWORD
- Tick Add Default Route
Click OK — the interface status should change to connected.

Note: If you have an existing default route, you may need to remove it first or lower its distance before adding the PPPoE client.

Tenda Router – PPPoE WAN Setup

These steps apply to most Tenda home and office routers. The exact menu names may vary slightly between firmware versions.

Steps

Open a browser and navigate to the router admin page:
```
http://192.168.0.1
```
Log in with your admin credentials (default is usually admin / admin).
Go to Advanced → WAN Settings (some firmware versions show this as Internet → WAN).
Set WAN Connection Type to PPPoE.

Enter your credentials:

PPPoE Username: YOUR_USERNAME
PPPoE Password: YOUR_PASSWORD

Set Connection Mode to Always On (recommended).
Click Save. The router will dial and obtain an IP from the ISP. The WAN status light should turn solid.

Tip: After saving, go to Status → WAN to confirm a public IP address has been assigned.

XPON / GPON ONT – PPPoE WAN Configuration

These steps apply to common GPON/XPON ONT devices (Huawei, ZTE, Nokia, etc.). Exact menu paths may differ by manufacturer and firmware.

Steps

Log in to the ONT web interface. The default gateway is usually:
```
http://192.168.1.1
```
Navigate to Network → WAN (may appear as Basic → WAN Configuration on some models).

Click Add or edit the existing Internet WAN profile and set:

Connection Type : PPPoE
Service Type    : INTERNET
PPPoE Username  : YOUR_USERNAME
PPPoE Password  : YOUR_PASSWORD
VLAN Mode       : Tag (if required by your ISP)
VLAN ID         : <as provided by ISP>

Make sure NAT is Enabled if this ONT also acts as a router (bridge mode users can leave NAT off).
Click Apply / Save. The ONT will dial and the Internet LED should turn green within 30 seconds.

Bridge mode note: If the ONT is in bridge mode, configure the PPPoE client on your downstream router instead (e.g., MikroTik or Tenda guide above).

Huawei ONT – specific path

Go to Basic → WAN Configuration.
Select the INTERNET WAN profile and click Modify.
Change Connection Type to PPPoE.
Enter username and password, then click Apply.

ZTE ONT – specific path

Go to Network → WAN → WAN Connection.
Click New or edit the existing profile.
Select PPPoE as the connection type, enter credentials, and save.

Connection Troubleshooting

Work through these steps in order. Most PPPoE issues are resolved by step 4.

Step 1 – Verify Credentials

Incorrect credentials are the most common cause of failure. Double-check:

Username is entered exactly as shown in your account (case-sensitive).
Password has no leading or trailing spaces.
Use See Credentials on the customer page to get the latest password.

Step 2 – Check Physical Connection

Ensure the fibre or ethernet cable from the ISP is firmly seated in the WAN port.
Check that the ONT/modem power LED is solid (not blinking red).
For GPON: confirm the PON LED is solid green (optical signal present).

Step 3 – Restart Devices in Order

Power off your router/ONT completely (unplug).
Wait 30 seconds.
Power on the ONT/modem first — wait for it to sync (PON/DSL LED solid).
Power on your router and let it dial.

Step 4 – Test PPPoE Dial on MikroTik

Run a manual test to see the exact error from the RADIUS server:

/interface pppoe-client print detail

Common status messages:

"Authentication failed" / error 691

Wrong username or password. Reset the password from the customer page and try again.

"No response from server"

The PPPoE server is not reachable. Check that the WAN link is up and the ONT is online. Verify the RADIUS server is running on your ISP management dashboard.

"Account disabled" / error 718

The PPPoE account is suspended. Check the customer account status and top up if necessary.

"Session limit reached"

The account is already connected on another device. Disconnect the existing session from the customer page (use the Connect action) and retry.

Step 5 – Check ISP Side

Confirm the account is active and not expired in ISPMan.
Check the Sessions section on the customer page — an active session means the account is already online elsewhere.
If using a profile with a data cap, verify quota has not been exhausted.

Step 6 – Ping Test After Connection

Once the PPPoE session is up, confirm internet connectivity:

/ping 8.8.8.8 count=4

If pings fail but the PPPoE session is connected, check firewall rules and the default route on the router.

Still stuck? Contact support at [email protected].