HomeAP — Complete Guide

1. Who HomeAP is for

You're running WiFi at home — your own apartment, a family villa, a small shop counter, or maybe an apartment building where you share internet with neighbors and want to keep things organized. You have one router (or a small mesh) and a handful of regular users (family, roommates, employees, tenants).

You don't sell hourly vouchers. Your users are people you know. They each have a username and password, or their phone is auto-bound by MAC address. Money side is simple too — you pay WitRADIUS a flat monthly subscription based on the plan you pick.

Use cases this fits

• Home / villa — control which devices connect, keep kids off after bedtime
• Apartment building — shared internet, bill 4-8 neighbors a fixed amount each month
• Small shop — staff WiFi separated from customer WiFi, daily quotas to prevent abuse
• Co-living / shared housing — each tenant has a username, fair-use policy enforced
• Small office — 5-20 employees, no need for an "Admin tier" account

What's different from Business Owner

	Business Owner	HomeAP
Pricing model	Per-hotspot, scales with concurrent users	Flat residential plan you pick from a catalog
Plan changes	Email support	Self-service "Change plan" button
Voucher cards	✅ Full system	❌ Not available
Printing templates	✅	❌ Not available
WiFi distribution	Codes sold to walk-ins	Username/password or MAC-binding for known users
Billing relationship	"Provider" — bills WiFi customers + pays WitRADIUS	"Subscriber" — pays WitRADIUS, may bill household informally

If you want to sell hourly codes to strangers, you should be a Business Owner account (see the Business Owner guide). HomeAP is for the simpler "I just want clean WiFi for people I know" case.

Your scope

Eleven menu items, plus a Change Password shortcut at the bottom:

Group	Menu items
Daily	Dashboard, Hotspots, Login Pages, Profiles, WiFi Users, Sessions
Insights	Statistics, Traffic Accounting
Money	My Plan, My Billing
Procurement	Hardware

Your server is auto-provisioned (just like Business Owner accounts) — no infrastructure configuration on your side.

---

2. Dashboard

Open it daily for a quick health check.

What you see

• Active sessions right now — how many devices are connected
• Today's data usage — total GB consumed across all devices
• Plan utilization — percentage of your monthly quota used so far
• Top users by data — heaviest consumers (catch a teenager streaming Netflix in 4K all night)
• Recent activity — last logins, last devices added
• System status — green = healthy

The plan utilization meter is the one to watch — if you hit 90% on day 15 of the month, you either need a bigger plan or a chat with whoever's downloading.

---

3. My Plan

This screen is unique to HomeAP. It's where you see your residential plan and switch it self-service.

What you see

• Current plan — name, monthly price, included data quota, included device count, speed caps if any
• Renewal date — when the next billing cycle starts
• Usage this cycle — data used / data included
• Upgrade / downgrade — button to switch to a different plan from the catalog

Switching plans

1. Click Change plan
2. Browse the residential plan catalog (small / medium / large; sometimes named after data tiers like "50 GB", "200 GB", "Unlimited")
3. Pick the new plan
4. Review the proration: if you upgrade mid-cycle, you pay the difference now; if you downgrade, the lower price applies from next cycle
5. Confirm. The new plan activates immediately for upgrades, or at the next cycle for downgrades

Other roles (Admin, Business Owner) cannot change plans self-service — they email support. HomeAP is the only role with this button, because residential plans are simpler and the catalog is fixed.

Why plans, not per-hotspot pricing

HomeAP is meant to be predictable for households. You pick a plan, you pay that amount, done. No surprise bills from a busy weekend. Business Owner accounts use per-hotspot pricing because they have variable revenue and need that flexibility — HomeAP users want the opposite.

---

4. My Billing

The money side, separate from the plan-management side.

Sub-tabs

Account balance

Top-up your prepaid balance with a card or bank transfer. Your monthly plan fee is deducted from this balance on the renewal date.

Invoices

Every month an invoice is generated for your plan. Pay with a saved card or upload a bank-transfer receipt.

Transactions

Full history of top-ups, plan charges, refunds, and adjustments. Export as CSV for your records.

Payment methods

Cards are tokenized — we never store your full PAN.

Auto-pay

Enable auto-pay so the monthly plan fee is charged to your card automatically. Service suspends after 7 days unpaid; auto-pay prevents this hassle.

---

5. Hotspots

Even though you usually have just one, the hotspot screen is full-featured (you might add a mesh node or a guest AP later).

Adding a hotspot

1. Click Add hotspot
2. Name (e.g. "Living room", "Lobby AP", "Shop floor")
3. Address (used for billing and on receipts)
4. Map pin (optional, useful if you ever upgrade to multi-location)
5. Hardware model from catalog (or "DIY" if you flash your own)
6. Login page (see §6 — create your design first)
7. Default profile
8. Save → status Pending until provisioned

Provisioning the router

Same three options as other accounts:

• Cloud-flash — bought from us, plug and play
• DIY flash — download image, flash via recovery, enter activation code
• Existing OpenWrt — paste a one-line install script in SSH

Once status flips to Online, you're live.

Editing & deleting

Edit anytime; changes apply within ~60 seconds. Delete drops active sessions and stops billing the next cycle (your plan covers all hotspots up to the plan's included count).

Firmware

Hotspot detail → Firmware tab → one-click upgrade. We test for 14 days internally before releasing.

---

6. Login Pages

Even at home, the captive portal is what your guests see. Make it look nice.

Templates

We ship: minimal, photo-background, residential, café, voucher-only, form-based, social login. For HomeAP the residential template is usually a good fit — clean, family-friendly, optional household logo and welcome text.

Customizing

• Branding — your name or family name, primary color, font
• Background — solid, gradient, or photo
• Auth methods — username/password is most common for HomeAP. Social login (Facebook / Google) for guests. Free with-ads if you want to monetize neighbor access. OTP-by-SMS available with extra charges
• Languages — toggle which languages appear on the splash
• Terms — your text or a PDF (optional but recommended)

Linking to a hotspot

Reusable design: edit any hotspot → choose a login page from the dropdown.

Deleting

Yes — confirm no active hotspots use the page first.

---

7. Profiles

A "WiFi product" — even though you're not selling them, profiles still define what each user gets.

Common HomeAP profiles

• "Family" — unlimited time, unlimited data, no speed cap (for parents)
• "Kids" — unlimited time, 5 GB / day cap, idle timeout 30 min, blocked 10pm-6am
• "Guest" — 4 hours / day, 1 GB / day cap, low priority bandwidth
• "Tenant" — for apartment building owners: monthly 100 GB, recurring, MAC-bound

Fields

• Name, time quota, data quota, speed limits, concurrent sessions, validity window, idle timeout, monthly recurring, hotspot scope

You have full CRUD — create, edit, delete. Standard rule: don't delete a profile in active use; migrate users first.

---

8. WiFi Users

This is your "directory of people who can use my WiFi". Different mental model from Business Owner — these are humans you know, not anonymous voucher purchasers.

Adding a user

1. Click Add user
2. Username (their first name, "kids-tablet", "tenant-203", etc.)
3. Password (auto-generated or set yourself; share via WhatsApp or paper)
4. Profile (which "package" they get — see §7)
5. Optional MAC binding (if their device is fixed, e.g. a smart TV — auto-connect, no password prompt)
6. Save

What you can do

• Edit profile, password, expiry
• Disable (e.g. teenager grounded for the week)
• Reset accounting (clear data counter — useful for monthly cycles)
• Delete a stuck session (if a device froze)
• Delete user entirely

Filters

Filter by profile to see all "Kids", or by status to see who's currently active. Useful if your family asks "who's using all the bandwidth right now".

---

9. Sessions

Every connection produces a session record.

Columns

Username, hotspot, started, stopped, duration, bytes in/out, terminate cause, MAC, IP.

HomeAP-specific use cases

• "Kids said WiFi was off all afternoon" → check sessions, see they actually streamed 8 GB between 3-7pm. Have a chat
• "Tenant in flat 3 says their internet was down yesterday" → check sessions for that username, confirm or deny
• "My new smart TV won't stay connected" → check sessions, look for repeated brief sessions every few minutes (often weak signal — move the AP closer, add a mesh node)

---

10. Statistics & Traffic Accounting

Statistics

• Hourly traffic — when's your house busiest? Late evenings? Mornings?
• Top users — heaviest consumers
• Online count — concurrent devices over time (good for sizing your next plan)
• Reports — PDF/CSV for any chart

Traffic Accounting

• Usage by user / hotspot / date range
• Daily breakdown of total traffic
• Virtual Routers — only useful if you ever sub-divide your account (most HomeAPs ignore this)

---

11. Hardware

Order routers from us, pre-flashed.

Catalog

• Mikrotik hAP ax² / ax³ — most popular for homes (small, quiet, powerful)
• TP-Link Omada — apartments / mesh (if your router signal doesn't reach the back room)
• Ubiquiti UniFi — overkill for most homes but available
• Custom — request a quote

Cart & checkout

Add to cart, ship to your home address, pay via balance or card. Track shipping by email link.

DIY

Don't want to buy from us? Download the firmware image and flash yourself.

---

12. Tips & playbook

First week

1. Add the hotspot, provision the router, confirm Online
2. Customize the login page — your name, household logo, friendly welcome
3. Create profiles: Family, Kids, Guest at minimum
4. Add household users: yourself (Family), kids (Kids), partner (Family)
5. Test from a phone — log in as "Kids" and confirm the data cap works
6. Top-up your billing balance to cover at least the first month
7. Optionally enable auto-pay

Daily / weekly

• Glance at the dashboard if you suspect bandwidth abuse
• Check My Plan mid-month to see usage vs quota — upgrade if you're consistently over

Monthly

• Pay the invoice (or auto-pay does it)
• Quick review of Statistics → top users, hourly traffic

Sharing with neighbors (if you do this)

• Create a separate user per neighbor (don't share one login — you can't disable individuals)
• Use the Tenant profile (recurring monthly quota)
• Bill them informally cash/bank-transfer; the WitRADIUS billing is just for what you owe us

Things you should NEVER do

• Don't share your master HomeAP login. Each person gets their own user account
• Don't delete a profile in active use
• Don't forget to top-up balance — service suspends after 7 days unpaid

When to upgrade to Business Owner

If you find yourself wanting:

• To sell hourly codes to walk-in customers → Business Owner
• More than one location with separate billing → Business Owner
• Voucher cards / printing templates → Business Owner

Email us — upgrade is free, your existing data is preserved.

When to call support

• WiFi down completely after a power outage and won't come back
• Plan-change button doesn't show the option you want
• Billing question or payment dispute
• Anything else not covered here

[email protected] — usually a few hours to reply.