Skip to content

Getting Started Guide ​

Welcome! This guide will help you start using the WiFi Management Portal to manage WiFi at your business location.

Logging In ​

Step 1: Access the Portal ​

  1. Open your web browser (Chrome, Firefox, Safari, or Edge)
  2. Go to your portal URL (provided by your service provider)
  3. You'll see the login screen

Step 2: Enter Your Credentials ​

  1. Enter your email address
  2. Enter your password
  3. Click "Log In"

First Time Login?

Your service provider will give you:

  • Portal URL (website address)
  • Your email address
  • Initial password (change it after first login!)

Step 3: Change Your Password (First Time) ​

For security, change your password on first login:

  1. Click your profile icon in the top right
  2. Select "Change Password"
  3. Enter your old password
  4. Enter your new password (twice to confirm)
  5. Click "Update Password"

Understanding Your Dashboard ​

After logging in, you'll see your main Dashboard:

📊 Quick Stats Cards ​

At the top, you'll see important numbers:

  • Total Customers - How many people have used your WiFi
  • Online Now - How many are connected right now
  • Active Plans - How many WiFi packages are currently active
  • Today's Revenue - Money earned from WiFi today

📈 Charts and Graphs ​

Below the stats, you'll find:

  • Daily Connections - Graph showing WiFi usage over time
  • Popular Times - When your WiFi is busiest
  • Recent Activity - Latest customer connections

Your First Tasks ​

Task 1: Create a Free WiFi Plan ​

Let your customers use WiFi for free for a limited time:

  1. Click "Packages" in the left menu
  2. Click "+ Create Package" button
  3. Fill in the details:
    • Package Name: "Free 30 Minutes"
    • Type: Select "Free"
    • Validity: 30 minutes
    • Data Limit: (leave blank for unlimited)
    • Speed: (leave default or set your preference)
  4. Click "Save"

Recommendation

Start with a 30-minute free WiFi plan. This gives customers enough time without overloading your network.

Task 2: Set Up Automatic Free WiFi ​

Make customers automatically get free WiFi when they log in:

  1. Go to "Settings" in the left menu
  2. Click "Operator Settings"
  3. Find "Free Package Settings"
  4. Toggle "Auto-assign free package" to ON
  5. Select your free package from the dropdown
  6. Set "Renewal Interval" (how often they can get free WiFi again)
    • Example: 1 day (means they can get 30 free minutes once per day)
  7. Click "Save Settings"

Now every new customer will automatically get your free package!

Task 3: Customize Your WiFi Login Page ​

Add your business branding to the WiFi login page:

  1. Click "Splash Pages" in the left menu
  2. Click on "Default Splash Page" (or create a new one)
  3. Upload Your Logo:
    • Click "Upload Logo"
    • Select your logo file (PNG or JPG recommended)
    • Logo will appear at the top of the login page
  4. Customize Text:
    • Welcome Message: Add a greeting (e.g., "Welcome to [Your Business Name]")
    • Terms & Conditions: Add your WiFi usage terms
  5. Choose Login Methods:
    • Toggle ON the login methods you want:
      • ✅ Mobile OTP (customer enters phone number)
      • ✅ Username/Password
      • ✅ Voucher Code
  6. Click "Save Changes"

Task 4: Generate WiFi Vouchers ​

Create voucher codes to give or sell to customers:

  1. Go to "Voucher Series" in the left menu
  2. Click "+ Create Voucher Series"
  3. Fill in the details:
    • Series Name: "Daily Pass Vouchers" (for your reference)
    • Package: Select the package customers get with this voucher
    • Quantity: How many vouchers to create (e.g., 100)
    • Price: How much you sell each voucher for (optional)
    • Expiry Date: When unused vouchers expire
  4. Click "Generate"
  5. Download or print the voucher list

Using Vouchers

  • Print vouchers and sell them at your reception/counter
  • Display voucher codes on table cards in your restaurant
  • Include vouchers in hotel room welcome packets
  • Email vouchers to event attendees

Common Tasks ​

View Who's Online Right Now ​

  1. Go to "Dashboard"
  2. Look at "Active Sessions" section
  3. You'll see:
    • Customer name/phone
    • Connection time
    • Data used
    • Which plan they're on

View All Customers ​

  1. Click "Subscribers" in the left menu
  2. You'll see a list of all WiFi users
  3. Use the search box to find specific customers
  4. Click on any customer to see their details

Create a New Customer Manually ​

Sometimes you want to create an account for a regular customer:

  1. Go to "Subscribers"
  2. Click "+ Create Subscriber"
  3. Fill in:
    • Name: Customer's name
    • Phone: Their mobile number
    • Email: Their email (optional)
    • Username: Login username
    • Password: Login password
  4. Optionally assign them a package
  5. Click "Create"

Give the username and password to your customer!

Assign a Package to a Customer ​

  1. Go to "Subscribers"
  2. Find the customer in the list
  3. Click "Assign Package" button
  4. Select the package from dropdown
  5. Click "Assign"

The customer will immediately get internet access with that package!

Create a Paid WiFi Package ​

Create packages you can sell to customers:

  1. Go to "Packages"
  2. Click "+ Create Package"
  3. Example settings for a "Daily Pass":
    • Package Name: "24 Hour Premium Pass"
    • Type: "Prepaid"
    • Validity: 1 day
    • Data Limit: 10 GB
    • Price: $5.00 (or your currency)
    • Speed: (set bandwidth limit if needed)
  4. Click "Save"

Understanding Package Types ​

Free Package ​

  • No cost to customer
  • Automatically assigned when customer logs in
  • Time-limited (e.g., 30 minutes, 1 hour)
  • Can renew after set interval

Prepaid Package ​

  • Customer pays before using
  • Can be voucher-based or direct assignment
  • Fixed validity period
  • Expires after time runs out

Unlimited Package ​

  • No data limits
  • Valid for set time period
  • Good for premium customers or VIP access

Limited Package ​

  • Has a data cap (e.g., 5GB, 10GB)
  • Slows down or stops when data runs out
  • Fixed validity period

Tips for Success ​

💡 Best Practices ​

For Restaurants & Cafes:

  • Offer 30-60 minutes free WiFi
  • Require mobile number for marketing
  • Renew once per day to encourage return visits

For Hotels:

  • Give room number-based accounts
  • Offer tiered packages (basic free, premium paid)
  • Track usage per room

For Retail & Malls:

  • Short free sessions (15-30 minutes)
  • Collect emails for promotions
  • Limit renewal to once per visit

For Co-working Spaces:

  • Create member accounts with unlimited access
  • Offer day passes for visitors
  • Track bandwidth usage per user

🎯 Quick Wins ​

  1. Start Simple: Begin with just free WiFi
  2. Add Branding: Customize login page with your logo
  3. Collect Data: Enable mobile number login for marketing
  4. Monitor Usage: Check dashboard daily to see patterns
  5. Upgrade Later: Add paid packages when you're comfortable

Need Help? ​

Common Questions ​

Q: How do I see who's using the most data?

  • Go to "Subscribers" and sort by data usage

Q: Can I block a customer?

  • Yes! Go to "Subscribers", find the user, click "Block"

Q: How do I change the free WiFi time limit?

  • Edit your free package and change the validity period

Q: Can customers see how much data they've used?

  • Yes, if they log into the subscriber portal (if enabled)

Q: How do I print vouchers?

  • Go to "Voucher Series", select your series, click "Download" or "Print"

Getting Support ​

  • 📧 Email: support@example.com
  • 📱 Phone: +1-XXX-XXX-XXXX (Mon-Fri, 9am-5pm)
  • 💬 Live Chat: Click chat icon in bottom right of portal
  • 📖 Help Center: Click "?" icon for context help

What's Next? ​

Now that you're set up, learn more about:


Success!

You're all set! Your customers can now connect to WiFi through your branded login page.

Released under the MIT License