Skip to content

Subscribers ​

Subscribers are customers who connect to your WiFi network. Each subscriber has login credentials, contact information, and an assigned package that controls their access.

Overview ​

Navigate to Subscribers in the sidebar to view all WiFi customers. The table displays customer details, current package status, and connection activity.

Table Columns ​

ID - Unique customer identifier.

Name - Customer's full name.

Username - WiFi login username (clickable to view details).

Email - Email address.

Phone - Phone number with country code.

MAC Address - Device hardware address (if registered).

Package - Current WiFi plan assigned to customer.

Status - Account status:

  • Active (🟢) - Has working package, can connect
  • Inactive (🔴) - No current package
  • Expired (🔴) - Package time ran out
  • Created New (🟠) - Just registered, no package yet

Session Active - Shows if customer is online now:

  • Active (🟢) - Currently connected
  • Inactive (🔴) - Not connected

Data Usage - Total data consumed (formatted as KB/MB/GB).

Created At - Account registration date.

Adding a Subscriber ​

Click + Add to create a new customer account. Fill in the required fields:

Name (required) - Customer's full name.

Username (required) - WiFi login username (minimum 3 characters, must be unique).

Email (required) - Valid email address.

Phone (optional) - Country code + number (e.g., +91 9876543210).

Password (required) - Login password (minimum 6 characters).

Comment (optional) - Internal note about this customer (not visible to customer).

Hotel Setup

For hotel guests, use room number as username (e.g., "room301") and a simple password. Add checkout date in the comment field.

Viewing Subscriber Details ​

Click on a customer's username or the view icon (👁️) to open their profile page showing:

  • Basic information (name, email, phone, MAC address)
  • Current package details (name, validity dates, status)
  • Data usage summary (total consumed, upload/download breakdown)
  • Connection history (past sessions)

Managing Subscribers ​

Editing ​

Click the edit icon (✏️) to update customer information:

  • Name, username, email, phone
  • Internal comments

Password cannot be edited here—customers must use the "Forgot Password" option on the login page.

Renewing Package ​

Click the renew icon (🔄) to assign or extend a customer's package. This immediately updates their access permissions.

Disconnecting a Customer ​

Open a customer's profile page and, in the Session Information section, click Disconnect to instantly end their current WiFi session. They'll be sent back to the WiFi sign-in screen right away.

This only appears when the customer has an active session, and only ends their current connection - it doesn't remove their package or account, so they can simply log back in afterward.

When to Use This

Useful if a customer needs to be logged out immediately - for example, after checkout, to free up a session for someone else, or to force a fresh login after changing their package.

Unlocking OTP Requests ​

If a customer requests a mobile OTP code too many times, they're temporarily locked out and can't request a new one. Navigate to Reports → OTP Requests to see every OTP request with its lockout status, search by mobile number, and click Reset to immediately let that number request a fresh code.

Audit Log ​

Click the history icon (📜) to view all changes made to this customer account, including who made them and when.

Deleting ​

Click the delete icon (🗑️) to permanently remove a customer account. This action cannot be undone.

Deletion Is Permanent

Deleted customer accounts cannot be recovered. Consider using the Inactive status instead if you might need the data later.

Searching ​

Use the search box to find customers by:

  • Name
  • Username
  • Phone number

The table filters results as you type.

Common Tasks ​

Check Who's Online ​

Look at the Session Active column—green "Active" indicates the customer is currently connected.

Create Hotel Guest Account ​

Name: John Smith
Username: room301
Email: guest@hotel.com
Phone: +1 5551234567
Password: 301
Comment: Room 301, Check-out: Dec 15

Assign them a WiFi package after creation.

Find Customers Without Package ​

Scan the Package column for entries showing "-" (dash). These customers need a package assigned before they can connect.

Use Cases ​

Hotels & Resorts ​

  • Create accounts when guests check in
  • Username = room number for easy identification
  • Delete accounts after checkout
  • Add checkout date in comments

Cafes & Restaurants ​

  • Enable self-registration via WiFi login page
  • Create manual accounts for staff only
  • Search by phone to identify returning customers

Co-working Spaces ​

  • Create accounts for all members
  • Username = member ID
  • Track membership tier in comments
  • Provide unlimited packages to members

Next Steps

Assign WiFi packages to subscribers via the Packages page or distribute Vouchers for self-activation.

Released under the MIT License