Dashboard
- Subscriber counts (total and active).
- Money owed to you and what you've collected.
- Recent activity and anything needing attention.
Subscribers
The list
- Chips: All = Online + Offline + Not installed. Counts lines; accounts with no line and archived ones aren't counted.
- Not claimed: lines with no owner account yet, each with its claim link.
- Router: every list shows the router each line is on.
- Archive (sidebar): delete archived items for good. Only bills can be restored; a bill with payments can be restored, not deleted. Needs the Archive permissions.
Account statuses
- Prospect: interested, not signed up yet.
- Applicant: applied, waiting for approval or install. It's per line, not the person.
- Active: connected and billed. Only these count toward your fibyr.ph fee.
- Walled garden: overdue; only fibyr.ph opens (their account, bills and payment) until they pay. Not counted toward your fee.
- Disconnected: service cut off.
What you can do
- Add a subscriber with a plan and a NAP box & port. It goes to the nearest installer; billing starts after the install. They get a welcome email to sign in.
- Resend the invite: Send invite on the subscriber's search row.
- Import / export your whole list as a spreadsheet, one row per line (a subscriber with several lines gets a row each, grouped by their email). The export doubles as the import template.
planandboxare matched by their exact name.- A row with no PPPoE username still works if it has an email.
- Account numbers are made by fibyr.ph; any account column is ignored.
old_balancebecomes a "Previous balance (old system)" bill, so one payment for old and new bills matches instead of becoming credit.- Screenshot import: live columns (uptime, presence, sync, balance) are shown, not saved.
- Update due dates (Subscribers → Import / export):
- Pull your router, export, type each line's Due Date (2026-11-05 or 11/05/2026), import.
- Rows are matched by Router + PPPoE Username. Only the due date changes.
- It's the next bill's due date. A past date makes that bill now, overdue.
- Skipped: lines with no plan, lines with payments in fibyr.ph, unknown router or line, unreadable dates. Empty dates are left alone.
- Upload documents (ID, proof of billing, contract).
- Several lines: each has its own PPPoE secret, address, box & port, pin, Wi-Fi password and device MAC (Connections panel).
- Wi-Fi password requests (up to 5 a month): schedule, change, then mark done or decline.
- Another line: a live subscriber taps Request another connection in their portal; you approve and install it on the same account.
- Line actions after first online: Suspend, put on router and walled garden appear once the line is live (online once, or already on a router). Remove doesn't wait.
- Permissions: each line action has its own, under PPPoE lines in Roles & Permissions.
- Changes: the Subscription tab shows who last edited it; Changes lists who changed what, when.
- View as subscriber: the eye beside a claimed subscriber's name opens their My Account as they see it, look only. Exit comes back.
- Transfer a line with its bills and history: Transfer to another subscriber, under the line. The PPPoE login stays. Subscribers can't transfer a line with a bill overdue or due within 7 days; you can.
- Reconnect a disconnected subscriber from the green panel on their profile (optional reconnection fee, see Extra charges).
- Remove a no-line account on its row: cancels any pending application, drops it from your list; their login stays. Not while they have an active line or a transfer waiting. Permission: Remove an account that has no line from your ISP.
- Self-deactivation: subscribers can deactivate a line from the portal (on by default; toggle on the Billing page). Unpaid bills stay owed; Activate brings it back. With soft deactivation on, it stays alive at a slow speed.
Internet Plans / Profiles
- Create a plan: name, monthly price, speed. A subscriber's bill follows their plan.
- Change a plan any time; the new rate applies next cycle.
- Begin: the installer presses it to take an approved install (open to every installer until then). Steps unlock in order: pin the house, install list, payment, modem, Finish. They can hand it to another installer, who presses Begin again.
- Save & push to router (Payment step, before the modem): puts the line on the router (portal only), makes the bill (installation fee + extra items) and tells the subscriber to pay, online or cash to the installer. Extra items lock after it. Finish makes no bills; internet turns on once paid.
- Installation invoice (INS-…): fee, materials, any prepaid first month, and how it was paid. Open it from the installation page, the subscriber's page, Cash remittance or My Bills; print or PDF. Permission: Open an installation's invoice.
- Prepaid switch (Payment step): the line's Billing mode, following your setting unless changed. Prepaid: after Finish it stays on the walled garden until its first bill (made when it first comes online) is paid. Postpaid: online at Finish, billed at the end. Locks after Save & push to router.
- Messages: the applicant's messages are on the Applications card. The installer and owner reply; staff with Read the messages on an application can read them.
- Pay before the internet switches on: the installer sets the final amount (fee + materials) and releases it. Until paid (online or cash), the line is on the walled garden.
- Confirm the install within 24 hours of payment on Subscriber Applications, or the line goes back to the walled garden. You can turn this step off there.
- Installation settings (top of Subscriber Applications):
- Require a NAP box and port: off by default, so approvers can pick "No box yet (assign later)".
- Require an install list: off by default.
- Require the house location to finish: on by default. The installer pins the house before Finish.
- Require the house location to apply: off by default (Installation settings → House location). Applicants then pin their house wherever they apply.
- Approve without a box or installer: the office can pick "NAP box & port optional" and add them later; a field installer must pick a box. Until then the line uses your default router.
- Switch on now: with Turn a new line's internet on before the installation fee is paid, tick "switch on their internet now" at Finish to skip the pay-first hold (a cash fee becomes installer cash; an online fee stays on the bill). Mark installed, switch on now lifts a hold any time. Added lines skip the hold. Needs a router: greyed out with no box, or a box with no router.
- Extra materials: the installer picks them from inventory; fibyr.ph prices them, deducts stock and adds them to the amount. Each needs a ₱/unit price.
- Down payment not paid? Nobody can approve, the owner too; untick Require a down payment to approve without it. Same for a required valid ID. The fee bill asks for the down payment first; the rest stays on it.
- Installments: tick Allow delayed installation payment on an application to split the fee over up to 3 monthly bills (same-named permission).
- Nearby Internet Demand (top of Subscriber Applications): barangays searched on Find an ISP near your boxes.
- Applying from Find an ISP: they send the barangay, municipality, province and the plan they chose; you set the spot, box and port when approving.
- Cancel an application before it goes live (a pushed secret is pulled back; the account and installed lines stay). Reject declines a new one. Both can be archived. End a live line from the subscriber's page.
- Speed boost: a faster plan for the booked hours, then it reverts. Billed by the minute (from 11 seconds) from when the router applies it. Prepaid pays ahead, unused minutes become credit; postpaid pays minutes used. Not applied within 2 minutes: cancelled, not billed. Needs the faster plan's profile on the router.
- Paid boosts: subscribers book them in their portal at the faster plan's hourly price plus your Speed boost percentage (Billing). Free speed boost on a line (subscriber page → Active Subscription) makes that line's boosts free. Dunning grace there spares that line until its date.
Coverage Boxes (NAP boxes)
- Add a box: location and number of ports. New box: goes through the installer flow. Existing box: live right away.
- Box tasks are on the installer's My Jobs. With Activate boxes on their role, "Activate the box when done" is ticked at Finish, so it goes live without the office.
- Box and port per line (no double-booking), in the Connections panel. A transferred line leaves its port.
- Installers can approve applications and assign box & port.
- Full boxes and free room show at a glance.
- Topology: router → OLTs → PONs → main boxes → NAP boxes (missing levels are skipped). Under each NAP box: its ports, the secret on each, and its ONU light (by the line's MAC, or the ONU installed on it in Inventory). Green −8 to −21 dBm, light yellow −21 to −23, yellow −23 to −27, dark orange beyond; yellow or dark orange opens Add a task (Repair or Line check). Not linked yet? Click it to see how. The same light shows on the OLT page, the Subscribers list and the subscriber's page.
- Outages: a NAP box, main box port, main box or PON with 2+ lines, all offline on the router, shows Outage · all N lines offline. Uses uptime monitoring's reading, so it needs it on. Lines switched off on the router don't count; a router that doesn't answer counts neither way. On the OLT pages the router icon is green when it answered, red when not. The mark updates by itself.
- Give boxes their barangay to show up on Find an ISP with your plans and rating.
- Router: every NAP box and main box has one; a NAP box on a main box takes the main box's.
- Router filter (above the tabs): one router at a time in Boxes, Main Boxes and Topology. Boxes with no router always show.
- Main boxes (optional): the upstream boxes NAP boxes hang off (Main Boxes tab). Removing one leaves its NAP boxes standalone.
- Main box split: 1:2, 1:4, 1:8, 1:16 or 1:32, once. That's its number of ports.
- Ports: each carries up to its max lines (4 to 128, default 16, set on the main box), e.g. one 16-port NAP box or two 8-port boxes.
- Wire NAP boxes: Main Boxes → NAP boxes. Tick them, pick each one's port (required) and what it's fed through. Ticking a box from another main box moves it; unticking removes it.
- Fed through: when a NAP box's cable runs through another NAP box on the same port, pick it. Splitter size and light estimate follow it.
- Port problems (over the max, or a NAP box with no port) still save but show in red, and in a list at the top of Coverage Boxes.
- NAP box ports: taken by the line set on it, or by an approved extra line waiting install. Red under the box: a line with no port, two lines on one port, or a port the box doesn't have. Fix it on the subscriber page.
- Optical topology (optional): PON → Main box → Ports → NAP boxes. A node with anything under it can't be removed.
- PON limit: every PON needs its router, OLT and subscriber limit (e.g. 64 or 128); router and OLT can't change after. Ports under it can't pass the limit.
- Light loss: each NAP box shows an estimate against the PON's optics (B+ 28 dB, C+ 32 dB). Yellow = within 3 dB, red = over. A warning only; pin the boxes for the fiber part.
Port Finder: who is on which port? Coverage Boxes → Port Finder, at the box:
- Pick the router, then the box.
- Set the box's location and Save.
- Press Start. It checks every 1 to 3 seconds, pauses above 80% router CPU, stops after 30 minutes.
- Tap a port, unplug it. The modem that goes offline shows under Possible modems (10 to 30 seconds).
- Plug it back and watch it return. Repeat to be sure.
- On an OLT? (Huawei, HSGQ or VSOL EPON) Tap Check the OLT after unplugging: the modem that loses its light is named, with its signal. It also finds modems that don't use PPPoE.
- Mark as suspect, then Assign to Port: the line is now on this box and port, Verified by Port Finder. Whoever was on it loses it.
Port check circle (Ports column): green all checked, amber partly, red not checked, grey nobody on a port.
Read-only. A Power-Up; staff need "Use Port Finder". PPPoE keepalive must be on (unless the box is on an OLT).
Cable Planner (installation Step 3): tap the map at each pole from the NAP box to the modem. The install list's Cable meters are free; meters past them go on Extra items at your cable's Inventory price. At Save & push to router, type the actual meters. No cable in Inventory: saves without a fee. A Power-Up.
Subscriber Map
- Filter by status (pending installs, approved, active) to plan installations and routes.
- Pin a subscriber's location on their profile so it shows here.
How billing works
The cycle
- Bills are made automatically, every day.
- Due date (Billing page): a fixed day for everyone, or each line's install date.
- Fixed day: the bill is made on the due day; during your reminder days before it, subscribers are asked to deposit, unless their credit covers it.
- A newly installed line's billing starts the first time it goes online, not on the install day:
- First bill due: that day + the plan's cycle (30 days unless set).
- The installation fee is billed at install.
- Still never online a day after install? Your bell rings: check the modem's PPPoE login.
- Each next bill is made a full cycle early. Extra charges (boost, materials, plan change) go on the bill not yet due, even if paid early.
- Prepaid is always prepaid:
- At install: installation fee + first month, before the line turns on. That month starts when it first goes online.
- Each bill is due at the start of the month it pays for.
- A booked boost gets its own bill and starts once paid; unpaid after a day, it's dropped. Or start it now and bill it next time: Billing → Prepaid: put a speed boost on the next bill.
- A plan change starts next cycle, never right away.
- Postpaid: due at the end of the month used. A boost is added after it ends; a plan change can start right away (split by the minute).
- Payment being checked: an overdue subscriber who paid stays connected for the hours set in Overdue handling (blank = until you check).
- Total = plan + VAT (if VAT-registered) + extra charges − discount. With VAT included in the price, nothing is added. Overdue bills get a late penalty automatically.
- You confirm a payment; the bill is marked paid.
- Three choices on the Billing page (Billing cycle):
- Late penalty on bills paid in part: off by default (only unpaid late bills get it).
- No late penalty while a line has an open utang: off by default.
- Keep billing disconnected lines: on by default. Off: no new bills while disconnected, and the months off aren't billed later.
Overdue handling (optional, off by default)
Turn on dunning on the Billing page: an overdue line goes to the walled garden after the days you set, then disconnected. Per line; a payment under review pauses it; paying reconnects it.
Outages: credit for time with no service
- Your side went down? Billing → Record an outage: where, Whole days or Hours and minutes, and a reason. Or under When your routers were down, tick times of one router → Record ticked as one outage. Edit the Message to subscribers if you like (fill-ins:
{{customer_name}},{{company_name}},{{amount}},{{when}},{{duration}}). - It shows the lines and total credit before you save.
- Credit per line: plan price ÷ days in its period × days down (or × hours and minutes). No VAT; add-ons don't count.
- The bill isn't changed. Credit is used by itself on the next bill, or on a due bill at the hourly overdue check, so nobody is cut for money you owe them.
- The same days are never credited twice.
Walled garden: the "pay first" mode
An overdue subscriber stays connected to fibyr.ph only (their account, bills and payment); the rest of the internet is blocked. Paying restores them at once. Their portal counts down to disconnection.
No load to pay? One-time top-up access (minutes): they can give themselves full internet once to top up their e-wallet (0 = off).
- Set it up: add your router (Operations → Router) and press Test connection. fibyr.ph builds the
walled-gardenprofile and firewall rules (taggedfibyr-walled-garden; yours are never touched). - Billing → Overdue handling: tick "restrict to fibyr.ph instead of cutting off".
How to know it works:
- Walled-garden pool: walled and disconnected subscribers get addresses from their own pool, never your plans'. Router page → Walled garden → Set pool: create one (name, range like
10.250.0.2-10.250.3.254, gateway) or pick a free one. Restricted lines reconnect on it at once. It needs a masquerade (NAT); if none of yours covers it, the check says so and Fix adds one. Not set: they may get no address, and you're notified. - Check walled garden (Router page): pool and masquerade, both profiles, the allow-list, the firewall rules and their order. Fix rebuilds only fibyr.ph's rules.
- The check also runs daily at 5:00 AM; you're notified if the router changed.
- Test walled garden (30s) / Test deactivation (30s) on a line: check on a phone that only fibyr.ph loads. It switches back by itself (their internet reconnects twice).
- After every restrict or deactivate, fibyr.ph reads the router back: Router confirmed, or a warning and a notification.
The Routers page has the full steps and allow-list. The disconnect step is a full cut, or with soft deactivation a capped line that reaches only fibyr.ph.
Put in walled garden (on a line): only that line is limited to fibyr.ph, until:
- you press Restore, or
- they pay with nothing overdue (if you ticked When they pay), or
- the date & time you set passes.
Needs the router taken over. Permissions: Put a line in the walled garden, Take a line out of the walled garden, Run the 30-second walled garden test on a line. No top-up access for these lines.
Pause Internet (subscriber): now until Resume, or scheduled 30 minutes to 8 hours. Never lifts a restriction. Needs the router taken over.
Grace until (per subscriber): no auto-suspension or penalties until that date.
Utang: a subscriber asks with a promised pay date, or you use a bill's Utang button; you approve or decline. Then:
- Only the bill's status changes; due date, lines and amount stay.
- It's paid on the next bill that isn't utang or paid (made now if none), listed there ("Utang Jun 15 | INV-…") and in its total.
- A one-off bill (boost or charge) is paid on the next monthly bill, whichever line.
- The utang bill is frozen: no charge, discount or payment on it. Money on the listing bill pays the oldest utang first.
- The line is switched back on; overdue steps wait until the listing bill's due date.
- No undo: it stays utang until paid.
Payer rating: share of past bills paid on time (Excellent / Good / Fair / Poor).
Prorated billing
Connected mid-month? The first bill covers only the days left; full price from the next cycle.
₱1,500 ÷ 30 × 10 = ₱500
First bill ₱500; next full bill ₱1,500.
Prepaid or postpaid
- Billing mode (Billing → Billing cycle; postpaid unless changed) decides how a mid-cycle plan change is settled.
- Per line: set Billing to Prepaid or Postpaid on the subscriber's page, next to its box and port.
- A change applies from the next billing period.
- A plan change right away is split by the minute (the change's minute stays on the old plan after 11 seconds).
- At most one immediate change a minute.
- Downgrades start with the next bill by default. To allow them right away on postpaid: Billing → Plan changes → Allow downgrading right away.
- Not downgradable: tick it on the installation, or on the line (subscriber page → Active Subscription). Cheaper and slower plans stop showing for that line.
- Start billing (per line): bill now instead of waiting for it to come online.
- Boosts follow the mode: prepaid pays ahead (unused minutes back as credit); postpaid pays minutes used, on the next bill.
Penalties & discounts
- Late penalty: a surcharge on overdue bills (one click for everyone past due).
- Discount: a peso discount on a bill.
Extra charges & reconnection
- Add a custom charge on a bill (label + amount); it's its own invoice line.
- Reconnection fee: tick "Add reconnection fee" when reconnecting; it goes on the latest unpaid bill.
- Set a default reconnection fee once in Business & tax details so it's pre-filled (still editable).
Invoices & Official Receipts
- Service Invoice: issued when you bill.
- Acknowledgement Receipt (AR): confirms a payment.
- VAT (Business & tax details): 12 if VAT-registered, 0 if not. Added to the bill (default: ₱1,000 → ₱1,120) or included in the price (₱1,000 → ₱1,000, ₱107.14 of it VAT).
Collecting payments
How it works
- Payment methods (GCash, bank, QR) in settings; each can add a Convenience fee (%).
- Incoming limit (optional): a cap per account, how much to use, and reset day. Limited accounts take turns; you're notified when one rotates or the last is nearly full.
- Already received: fibyr only sees payments made through it. Edit the account and type what else it received since the reset.
- The subscriber pays you directly, then submits the reference number.
- Any amount is accepted. Less than the bill: account credit (Unverified until checked) that pays the bill once it covers it. More: pays it, the rest is credit.
- Bills open 7 days before due (change it under Billing cycle). Until then: Upcoming, not payable. Deposits any time.
- Recurring charges (e.g. ₱200 router rental): on the open bill and every new one, until removed or for the bills you set. Tick VAT if needed. Changes reach unpaid bills too.
- Name on invoices: the subscriber's name, their office, or office c/o them. Set by the subscriber in Account settings (or by you per bill if unowned). A paid bill keeps its name.
- Account credit pays whole bills by itself, oldest first per line. A bill paid in part gets Finish with credit.
- Last in | Last out: the date and time the subscriber last opened the app (even if still signed in from before), and last closed it or switched away. On their page and in the Subscribers list.
- Subscribers see one card per line: plan, amount due, Pay, plan change, boost, Wi-Fi password, transfer. Pay all pays everything, oldest first.
- Deposits: My Bills → Make a deposit. Credit at once; shows as Deposit for you to verify. Rejecting takes it back.
- Every submitted payment is accepted; verifying is your call. Until then it reads Unverified (Resend requested if bounced; Unpaid only if rejected).
- While unverified: no cutoff, no penalty. You're reminded if they wait too long.
- Confirm marks the bill paid (you can void later).
Confirming payments
- Each submission plays a "cha-ching" and lands in Payments awaiting confirmation.
- Confirm (settles), Reject (not real), Ask to resend (re-check the reference).
- Until verified, the subscriber can edit or cancel it; you're notified. A cancelled deposit's credit is taken back.
- Rejected or asked to resend before? A red sign by their name shows how often.
- The subscriber is told in the portal, by email and on screen.
Receipt Scanner auto-verification tool
- Switch it on under Power-Ups. The server reads uploaded GCash receipts; a matching amount settles the bill by itself.
- Suspicious or mismatched receipts stay Unverified with View receipt, for you to decide.
- Paid more? On their billing page: Keep as credit, Paid a past balance, or Other payment.
- Add to next bill: a label and amount (old balance, extra router) waiting for the next bill. Removable until that bill is made.
- Migrating? An
old_balancecolumn in the import adds a "Previous balance (old system)" bill, settled automatically when they pay old and new together. - Bulk verify: Payments received → Unverified, drop screenshots; each reference is matched. GCash: Credit rows only; bank: by invno.
- Payment not received (fake receipt): reverses it (bill reopens, credit taken back), the subscriber gets a popup, an overdue line is cut at once. The receipt photo is kept.
- A receipt for more than the bill auto-verifies but is flagged Overpayment. Extra covering their next bills is a deposit; anything beyond waits for your approval.
- Overdue steps apply the moment something changes (payment reversed, charge added, grace cleared, due date or plan changed, settings saved). The daily run is a backstop.
- Times use fibyr.ph's clock, so screenshots can't fake them. Receipt images are private.
Payment triage
Each submission is checked for amount, reference format and re-use, and labelled (questionable first):
- Looks good: nothing stood out.
- Worth a check: amount or reference is off.
- Flagged: the reference looks reused.
Online payments (optional)
Connect PayMongo or Xendit: subscribers get "Pay online" (GCash, Maya, card), confirmed automatically. Manual payments still work.
- Sign up at paymongo.com or xendit.co and finish their verification.
- fibyr.ph → Business Settings: choose the gateway, paste its Secret key.
- In the gateway's Webhooks, add the URL fibyr.ph shows, then paste the signing secret (PayMongo) or verification token (Xendit).
Support Tickets
- Subscribers (or you) open tickets; you reply, assign staff and track them to the end.
- Quick chat: pre-made messages (e.g. "My internet is down") subscribers tap to open a ticket. They can't resend one until its ticket closes; open tickets are capped.
- Notify staff: tick "Receive new-ticket & chat notifications" on a role. The owner is always notified.
- Auto-assign installation and technical tickets to the installer covering that box with the fewest open tickets (top of Support Tickets).
Daily Tasks
Share the Installer guide with your crew: a phone-friendly walkthrough, also in their sidebar and behind each application's Installation checklist button.
The fibyr Android app for subscribers and installers: on the fibyr.ph homepage (Download for Android). Always up to date; notifications reach their phones.
- Create a job and assign a technician. An installation job needs the installer to hold inventory (repairs and line checks don't).
- From Topology: a yellow or dark orange ONU light opens Add a task (Repair or Line check).
- Assign later: a job with no technician waits as Pending.
- Quick jobs by MAC: paste jobs one per line; a line with a device MAC links to that subscriber (set the MAC in their Connections panel first).
- Scheduling an installation notifies the subscriber of the date (toggle in Notifications).
- Install lists: reusable material lists (router, ONU, cable…) applied to a job in a click.
- Technicians see jobs with the materials checklist, update progress and upload photos. They install only equipment they hold and acknowledged; inventory updates by itself.
- Completing a job notifies you (flagged if the checklist wasn't met). Completing an install from Applications activates the subscriber; billing starts when the line first goes online.
- Home base: each installer sets an address and pin on their Account page; new installs go to the nearest. None nearby: you pick.
- Override: Mark Installed (Applications card): activate an already-connected subscriber without the installer. Delegate it with Finish an installation that isn't assigned to you (and Finish an installation before its fee is paid).
Inventory
- Record items with serials and stock counts; add your own categories on Add item.
- Products: items with the same category and name are one product. The Products tab lists each product per warehouse: quantity on hand and In stock / Low stock / Out of stock.
- Import: export, fill in the same file, import it back. New categories and warehouses are added; no warehouse = the default one; product details only fill blanks.
- Warehouses (Warehouses tab): add as many as you need. New items go into the default one unless you pick another on Add item. A warehouse still holding stock can't be deleted. Permissions: Add / Edit / Delete a warehouse.
- Add with OCR (Label Scanner tool): photograph labels; fibyr.ph reads serial, MAC, model and modem login. Permission: Add inventory with OCR.
- Device MAC and serial at install (Label Scanner tool): on the Install list step, tap the camera by Device MAC or serial; one photo fills both. Same permission.
- Assign to a holder when adding, importing or later. A serialized unit is pending until they acknowledge it.
- Price bulk materials (cable, connectors) per unit, so installers can log them as extra materials.
- Custody: the technician acknowledges on My Equipment, then can install, return, or pass it on (the teammate acknowledges). Every hand-off is logged.
- Sign-off: returns need Confirm returns; Mark installed needs Approve installations. Both sides are notified.
- Retrieve & replace: swap an installed unit for a same-category one in stock; the old one goes back to stock or is marked defective.
- Every move is in the item's History. Equipment never crosses companies.
Router & auto-connect
How fibyr.ph reaches your router
- Secure tunnel (recommended): works behind NAT or a changing IP. Paste fibyr.ph's setup block once in the router terminal, then Test connection. No port-forwarding.
- Direct (public IP / DDNS): enter the address, turn on API-SSL, firewall the API to fibyr.ph.
Connecting (one-time)
- On the MikroTik: turn on the API and make a dedicated login for fibyr.ph (not your admin).
- In fibyr.ph → Router, add it and fill in: Name, Host, API port (
8728, or8729for TLS), the API username & password (stored encrypted), a Default profile, and the Walled-garden profile (a PPP profile named exactlywalled-garden). Tick Active. - Several MikroTiks? Add each and give your boxes their router. Use the same profile names on every router.
- Test connection checks fibyr.ph can log in.
- Match your plans to the router's speed profiles. Done.
Router health (why the CPU/RAM/temperature are where they are)
Router health (Monitoring tab): what drives CPU, memory and temperature, plus uptime, RouterOS version and storage.
Uptime & downtime log (proof for "it's down!" claims)
60-day log (Monitoring tab) of when the router and tracked lines were online, without internet or down: evidence against false outage claims.
- Who to watch: Track all secrets, or search specific ones.
- Router vs modem: router up, line down = the modem was off. Router down = your side; those lines read "not monitored", never blamed.
- Not installed yet: never online and not on a router; not counted as Offline.
- Interval: pause, or check every 5 to 60 minutes (top of the tab). Gaps are marked.
- Subscribers see their own line's record on My Uptime.
/ppp/secret.)Core / upstream routers
Core / upstream router: tick "This is a core / upstream router" when adding a router above your PPPoE router with no subscribers. Never taken over or given secrets; fibyr.ph only watches it. Can't be changed later (archive and re-add).
Wire routers to a core: set Upstream core on a router's Details tab. If the core goes offline, the alert names the routers under it.
Monitoring a core: its up/down shows on its card; watch traffic on Interface Traffic (Read for 15 minutes).
Migration process
Migration process (sidebar): one router at a time. Keep it Read-only while migrating (nobody is cut). When enough have paid through fibyr.ph it shows Safe to take over; then turn on Take over PPPoE.
Hand lines over: lines pulled from a taken-over router stay with your old system until handed to fibyr.ph:
- Subscriber page → Migration → Hand this line to [your ISP], or Hand over all on the Router page.
- Until handed over, fibyr.ph never cuts, walls or deactivates it. Bills and syncing still run.
- One-way. Once all are handed over, new lines on that router are fibyr.ph's.
- Lines fibyr.ph installed are always fibyr.ph's.
Network Tools
Network Tools (Power-Ups): remote access, gaming / QoS, ZeroTier, CGNAT bypass, hotspot vouchers, VLAN setup, vendo machines. Pick the router at the top.
zerotier package, paste fibyr's join script, authorise the router.Each is a Power-Up; some need another first.
Vendo host contract: start it on the machine's row in Vendo WiFi. Either side can end it. Only the host can renew, and you're told.
OLTs have their own section: OLTs (read-only).
Interface Traffic (live)
Interface Traffic (Operations): live in/out per interface. Press Read for 15 min to watch every second; it stops by itself. Read-only.
WAN uplinks: label an internet interface with its provider and Mbps to scale its graph.
Extended monitoring: 1 to 4 weeks, by request. Once approved it reads every second, live. Paid from your fibyr credit per hour, minute by minute; stop any time. It stops when time or credit runs out.
What happens after it's connected
- Approve → fibyr.ph makes the PPPoE username & password (on the subscriber's page).
- Activate → created on the router. Disconnect / reconnect switches it off and on.
- Suspend → disabled and kicked; with the walled garden, moved to the portal-only profile.
- Speed boosts push the faster profile at once and revert after; billed by the minute from the router's confirm.
- Soft deactivation (optional): non-payers stay at a speed cap (e.g.
1M/1M), fibyr.ph only. A manual disconnect is a full cut. - PPPoE usernames are unique per router (two routers can each have "juan"). A line with no router needs a name unique in your ISP.
- Renaming a username removes the old one and pushes the new; they're offline until the modem is updated.
- Push failed (router unreachable)? fibyr.ph retries, then notifies you ("Router sync failed").
OLTs (read-only)
Operations → OLTs watches OLTs and ONUs, read-only. Part of the Router & Network Tools Power-Up.
- One router, many OLTs: each OLT is added on its own, with the router it's behind.
- After Sync: every ONU's serial, PON port, online/offline and Rx / Tx in dBm. Weaker than -27 or stronger than -8 dBm is highlighted.
- Brand & model are read from the OLT. ONU readings work for Huawei, HSGQ and VSOL EPON (many small brands are HSGQ inside). Others show "not supported yet". See Supported OLTs.
- Request support: a new OLT fibyr can't read yet shows this button. To let fibyr.ph in, add its support email (in the popup) to your Staff with full OLT access.
- One reading at a time per router: other OLTs behind it wait; Sync says which one is being read.
- Link to a line (OLT page): links an unlinked ONU to a subscriber by setting the line's MAC to the ONU's serial.
- Find OLTs: scans a router's devices over SNMP (your community) and pre-fills Add OLT. Nothing is added until you save.
Before you add an OLT
- Turn on SNMP on the OLT: read-only community (v2c) or a v3 user. Never read-write.
- Reach it through the router. In Add OLT, keep "Set up access on [router] automatically" ticked: 2 port-forward rules and 1 firewall rule (so the OLT's answers get through) are added first in their lists, on a free port, and removed with the OLT. The OLT goes on a secrets router, never a core. Needs a router connected by tunnel. To do it by hand instead, untick it and paste this in the router's terminal (your OLT's address in place of 192.168.1.10, a free port in place of 16161):
For a second OLT at 192.168.1.11, the same three lines (then move them to the top of their lists in Winbox) with 16162, 192.168.1.11 and "OLT access 2"./ip/firewall/nat/add chain=dstnat in-interface=wg-fibyr protocol=udp dst-port=16161 action=dst-nat to-addresses=192.168.1.10 to-ports=161 comment="OLT access 1" /ip/firewall/nat/add chain=srcnat dst-address=192.168.1.10 protocol=udp dst-port=161 action=masquerade comment="OLT access 1" /ip/firewall/filter/add chain=forward in-interface=wg-fibyr dst-address=192.168.1.10 protocol=udp dst-port=161 action=accept comment="OLT access 1"
Add an OLT
- Operations → OLTs → Add OLT.
- Name, brand, and the router it's behind.
- "Set up access automatically" ticked: the OLT's own address (e.g. 40.10.10.10). Unticked: the router's tunnel address and your forwarded port.
- SNMP version and read community (v2c), or v3 user and passwords.
- Test connection, then Save (or save untested; it's tested right after).
On an OLT's page
- Sync reads every ONU again; the list updates by itself when done.
- Test connection asks the OLT its model and firmware again.
- Edit: leave a password or community blank to keep it.
- Remove: to the Archive (delete for good there). Nothing changes on the OLT.
- History: its last 5 changes.
Permissions: See OLTs and their ONUs, Add an OLT, Edit an OLT, Remove an OLT.
Moving from another app
Bring everyone in while your old app stays in charge; switch over when ready. Exact PPPoE logins are kept, so nobody drops.
Step by step
- Add your router with "Active" OFF: fibyr.ph changes nothing on it.
- Test connection.
- Import subscribers: every PPPoE account with its exact login. Skips existing ones; no bills.
- Match your plans to the router's speed profiles.
- Set up billing day, payment methods, overdue handling. The router is still untouched.
- Go live: switch "Active" ON and stop the old app managing them.
- Claim links: one per line (subscriber page → Claim link). They sign in and the line is theirs. Expires in 60 days; Re-issue makes a new one. Welcome emails include it.
- Once claimed, the line shows the owner's own details (they keep them up to date).
- Connection Type (Residential, Business, VIP) is set per line.
- Whole base? Subscribers → Onboard migrated subscribers: copy links, Generate all, Download (CSV), progress. Sent links are never re-issued.
- Spreadsheet: Subscribers → Import, with each current PPPoE username and password.
- Screenshot import: Subscribers → Import from a screenshot of your old panel. A matching username is updated, a new one added.
Notifications
- In-app and email are free.
- Email Center (Subscribers page): email everyone, or by status, box, router or checked ones, with up to 3 images (kept 60 days). Anyone it can't email is on Can't email.
- Billing reminders go out by themselves: before the due date, on it, a final notice, and on the cutoff day. Lead time: Notifications → Channel Settings.
- Notify me when a subscriber is reminded: a matching alert for you.
- Creation alerts: a bell for each new application, installation or line, naming who did it (permission: New applications, installations and lines).
- Sounds: "cha-ching" for payments, a chime for the rest; mute with the bell's speaker icon.
- WhatsApp & Telegram: connect your WhatsApp Business or a free Telegram bot (@BotFather) under Channel Settings; every notification goes there too. Subscribers link themselves.
- SMS: a paid tool, coming soon.
Can't email
- A blast's unreachable people (no email, failed, or bounced) are listed on Can't email (sidebar, under Notifications).
- Bounced: sent but returned (wrong address, full inbox). Found by reading the sending mailbox every 15 minutes for 3 days; nothing in it is changed.
- Each row: name, phone, network (Globe, Smart, DITO) and a Call button.
- Mark called after calling, so your team knows. Tap again to undo.
- Per router: each shows its latest blast; a new blast resets only that router's list.
- Open to roles that can send email blasts.
Email Templates
- Edit your welcome email and other templates.
- Placeholders (name, billing date) personalise each email.
Reports
- Revenue and collections over time. Installer cash counts once marked received.
- Overdue accounts to follow up.
Expenses
- Record each cost (bandwidth, rent, power, fuel, equipment, cash salaries) with category, payee, amount and date.
- Category and Paid to are remembered as you type. Add a note if you like.
- Recurring: weekly to yearly; the next entry is added each period.
- Remind me (on the day, or 1 to 7 days before): a notification, popup and email to you and whoever can add expenses.
- Totals per month (or all-time), split by category tabs.
- Permissions: view (see), manage (add, edit, delete).
- Each month's expenses feed Profit sharing; Salaries & wages count as salaries there.
Cash remittance
- Cash a staff member records from a subscriber is theirs to remit. This page lists every cash payment and what each person holds.
- Each sees their own; a manager with view everyone's sees all (filter by person, month, status).
- Mark Remitted per payment or a person's whole amount; who and when are recorded.
- Also shows the period's expenses and net (cash minus expenses).
- Installations by installer: each fee (plan fee + materials) and how it was paid.
- Void: the collector (or an owner) presses Void, picks a reason and explains. Every other owner and business partner must accept; one refusal keeps it. Until then it still counts to remit.
- Permissions: view my cash to remit, view everyone's, reconcile.
Staff & roles
How roles work
- Roles are yours: start with Installer, Support, Manager, Checker; add, rename or delete (not one still assigned). Tick Counts as an installer to list a role's staff as installers.
- A permission opens one area or action. Controls a role can't use don't appear.
- Role colours: on an installation page, each checkbox shows a chip per role allowed to use it (only you see them).
- Each permission is one action. More than two actions show as sub-checkboxes under one row. A permission that needs another ticks and locks it.
- No role = no access: they can sign in, but every page is hidden.
- They get the alerts that match their access.
- Full access: everything you have, including Staff & Roles. Turning it on asks for your password or a code.
What stays yours only
- Adding/removing staff, assigning roles, and your fibyr.ph subscription & bills.
Adding someone
- Staff & Roles: enter their name and email (if any). With an email they sign in with a one-time code.
- No email? They're still staff (field work, roles, payroll) but can't sign in.
- Applicants show on the Staff list: add their specialization and Approve, or Decline.
- New staff can take field work right away; a role gives back-office access.
Business partners
- Different from staff. A business partner gets nothing from being one: no pages, bells or emails. Once they accept, they're on your Staff with no role; give them a role there for what they can open.
- Invite by email in Business Settings. They join your Staff when they accept (signed in with that email).
- One login, many ISPs: they switch ISPs from the account menu.
- Remove any time from the same panel; their Staff place goes too unless they have a role. The last owner can't be removed.
Profit sharing
- Set the % in Business Settings under Business partners. Any owner can change them; up to 100% in all.
- Changes apply from the 1st of next month.
- The monthly statement (every owner sees it, on the Profit sharing page in the sidebar):
- Balances count finished months; the current month shows "so far".
- Withdraw up to your balance any time; an owner pays it and marks it paid, or rejects with a reason.
- An owner who leaves keeps their balance; their share stops next month. Pay it out from the Balances list.
Payroll Tool
- Turn it on under Power-Ups (monthly fee); Payroll appears in the sidebar.
- Staff & salaries: set salaries (one fills the empty rows), untick On payroll for anyone not paid here, Save all. Pick the schedule: monthly, every 2 weeks or weekly.
- Run payroll: a draft with a payslip each, from the monthly salary. Won't start while someone has no salary; days are never paid twice.
- Adjust allowances and deductions; net pay updates.
- Apply to everyone (draft): one allowance or deduction on all payslips.
- Release: marked paid and locked; each staffer gets a printable payslip.
- Cash advances (vale): staff ask from their sidebar; approve, change or decline, or Give vale. One installment per pay; Skip vale this pay skips once.
- Permissions: Payroll view vs manage.
HR Tool
- Turn it on under Power-Ups (a monthly fee is added to your fibyr.ph subscription). An HR link then appears in your sidebar.
- Per staff member: position, status, date hired, birthdate, address & phone, emergency contact, SSS, PhilHealth, Pag-IBIG, TIN.
- Staff come from your Staff & Roles list. Control access with the HR permissions (view vs. manage) on each role.
Accounting
- First setup: where the books start, the year's first month, month locking, inventory method, percentage tax. Change later in Settings.
- Posts by itself, one way: bills, payments, credits and expenses. It only reads; nothing else in fibyr changes.
- Also posted:
- Payroll paid: salaries, vale installments, deductions held.
- Cash advances when approved.
- Installation cash with the installer until received.
- Business partners' shares paid.
- Your fibyr.ph subscription, payments and credit.
- Inventory, the way you chose.
- A changed record is reversed and posted again; entries are never edited.
- Needs your input: what paid each expense (cash, an account, the owner, unpaid), with supplier TIN and input VAT if you have them.
- Journal: every entry; add your own (capital, drawings, loans, depreciation, corrections; debits = credits). Yours can be reversed.
- General ledger, Trial balance and Chart of accounts (rename or add accounts).
- Statements, each its own page:
- Income statement: income, expenses, net income.
- Balance sheet: assets = liabilities + owner's equity.
- Cash flow: money in and out of cash, GCash, Maya and bank.
- Owner's equity: capital, drawings and net income.
- BIR books: cash receipts, cash disbursements, sales, purchases, general journal, general ledger.
- VAT and tax: output vs input VAT by month and quarter; percentage tax if on.
- Close month (if chosen): locks a finished month, for good.
- Print / PDF and Excel everywhere.
- Permissions: one per action in Accounting.
Affiliate marketing
- Avail it under Power-Ups. Subscribers see Refer a friend and earn, with their own link.
- Reward: a fixed amount or a % of the plan price, as account credit or cash.
- When: each paid bill of the referred person's first line, once or for the bills you set.
- Who counts: only someone new who applies through the link; never their own account.
- Who can refer: every subscriber, or only those with "Can refer friends".
- Cash: they ask to withdraw; you pay, then Mark paid (or Reject).
- Pause sharing: links stop working; people already referred keep earning their referrer. Resume sharing turns them back on.
- Permissions: Affiliate marketing (open, reward, who can refer, withdrawals).
Public profile & ratings
- Add your logo, cover photo, coverage areas and plans.
- Share your page: it has its own short link,
https://fibyr.ph/your-handle/profile. Open it with View public page and copy the address anywhere. - Subscribers can rate you; you choose whether ratings show.
- A subscriber with several lines can rate each, or all at once (counted once per line).
- Visible sections: choose what the public sees (plans, coverage, verified badge, tier emoji).
Business & tax details
- TIN, address, phone: printed on your documents.
- VAT rate: 12 if VAT-registered, 0 if not.
- VAT on bills: added (default) or included in the price.
- Reconnection fee: your default when reconnecting.
- BIR permit / ATP number: in the document footer.
Send from your own email
- Settings → Send from your own email, with a helper for Gmail, Outlook and others.
- Gmail: turn on 2-Step Verification, make an App Password at
myaccount.google.com/apppasswordsand paste it as the password. - Outlook / Microsoft 365 / Yahoo: same idea, with an app password.
- Unsure? Ask your provider for the SMTP server, port and security. The Gmail/Outlook buttons fill them in.
- Send a test to yourself, then tick Switch sending on and save.
Power-Ups
- 🚀 Power-Ups → All Power-Ups: turn each on or off; its monthly fee goes on your fibyr.ph subscription.
- Accounting shows Coming soon until offered.
Subscription
- No setup fee. You pay per active line at your tier's rate, rounded up to the top of your range but never past your tier's limit (ranges of 5: 78 lines → 80). Suspended and disconnected lines don't count.
- Voucher code? Redeem a voucher (Subscription or Renew page): it goes on your next subscription (free, or % off the plan; Power-Ups still bill). At ₱0, still press Pay ₱0.00. Remove it before then to reuse the code.
- Subscription history: plan and Power-Ups, paid up front; each month starts the day you subscribed.
- On Free: add and edit boxes, main boxes, PONs and OLTs. Using them needs a subscription.
- Invoice per bill: tier, tools, partner services and VAT (print or PDF).
- Paying: Pay, send to a fibyr.ph account, upload the receipt. A matching amount is confirmed at once; otherwise Unverified until checked.
- Renewing: a small panel at the bottom of the screen keeps your subscription in view.
- 7 days before: "Your subscription expires in 2 days", Renew with the amount (less your credit).
- Due day: "expires today"; unpaid: "Your subscription expired Oct 10" until you renew. Nothing is owed.
- Renewing ahead is kept as credit and pays the subscription on its due day.
- Deposit 2 or 3 months on the Renew page; it renews each month by itself.
- Nothing to renew? The Renew page still takes a deposit (from ₱1) as credit.
- One payment renews every waiting subscription, oldest first; the rest is credit.
- The panel hides once renewed and covered, or while a payment is being checked.
- Credits: Cash credit and Voucher credit tabs (voucher credit pays subscriptions only).
- Partner services: hire a fibyr.ph partner for a job (e.g. router setup) from Partner services on this page, or Book a service on a partner's portfolio.
- Describe the job; the partner quotes; you accept. Message each other on the booking.
- Once done, you have a few days to dispute; otherwise the fee goes on your coming subscription.
- A disputed job stays off your bill until fibyr.ph decides.
- Unpaid: reminder 7 days before; unpaid on the due day it expires (month dropped, nothing owed, credit used comes back). Renewing turns everything back on.
Activity log
- Every billing change, payment and edit is logged with who and when.
- Your audit trail.
- Settings history: every settings section has a History button showing its last 5 changes (when, who, from what to what), for those who can change it. Secrets only say "changed".
Request a feature
- Account menu → Request a Feature: a short title, its purpose and benefits.
- Your requests show their status (New, Planned, Done, Not planned); you're notified when it changes.
Signing in
- Sign in with a one-time code emailed to you.
- Password: set one in Account settings; codes still work.
- Two-step verification (off by default, Account settings): after your password, a 6-digit email code.
- Authenticator app (Google Authenticator, Authy) with recovery codes.
Still stuck? Use fibyr.ph Support inside your dashboard to reach our team.