Skip to main content
Documentation
Getting StartedQuickstart

5-Minute Quickstart

Go from a fresh account registration to an active, working billing service in five straightforward steps.

Go from registration to working service

This quickstart guide is designed for ISP owners, network engineers, and administrators setting up Nukta for the first time. It walks you through the shortest, safest path to production: create your workspace, configure your ISP branding, build your first internet package, connect a MikroTik router, and authenticate a live test customer.

CAUTION
Live Payments Safety

Do not start collecting live customer payments until you have completed a controlled test transaction. A saved payment credential verifies that your keys were entered, but executing a small test transaction confirms that your gateway callbacks and settlement accounts are fully operational.

What you need before starting

Before you begin, have the following items ready:

  • A working email address and mobile phone number for verification.
  • Your company/ISP name, preferred brand accent color, and customer support telephone number.
  • A MikroTik router running RouterOS v7 connected to the internet via any WAN uplink (DHCP, Static IP, or PPPoE client).
  • Details for at least one internet package (price, duration, upload/download speed limits).
  • (Optional) Payment gateway credentials (such as Paystack, Kopo Kopo, or mobile money) if you plan to accept automated online payments immediately.

Step 1: Create your ISP account and workspace

  1. Open the Nukta Sign Up Page.
  2. Enter your full name, email address, and a secure password (at least 8 characters, with uppercase, lowercase, numbers, and symbols).
  3. Check your email inbox and click the verification link.
  4. Verify your phone number via a quick 6-digit SMS one-time password (OTP).
  5. Enter your ISP name (e.g., MtaaniNet) and choose your unique subdomain prefix (e.g., mtaaninet). This claims your dedicated workspace URL: 
    https://mtaaninet.nukta.one
  6. Confirm your region (e.g., Country, Currency, and Timezone).
  7. Complete setup to launch your new Nukta dashboard.

Step 2: Configure your ISP identity and branding

  1. In your dashboard, open Settings → Branding from the left navigation.
  2. Review and configure your ISP identity:
    • ISP Network Name: The business name displayed on captive portals, customer receipts, and SMS messages.
    • Brand Accent Color: Select a theme color that matches your company branding.
    • Support Phone & Email: Public contact details shown to customers when they need assistance.
    • Portal Logo: Upload your company logo (PNG, SVG, or WebP) to display on captive hotspot screens.
    • Terms & Conditions: Enable terms of service for customer Wi-Fi access if required by local regulations.
  3. Click Save Changes.

Step 3: Create your first internet package

  1. In your dashboard, open Finance → Packages.
  2. Click Create Package.
  3. Choose the service type:
    • Hotspot: For walk-in customers connecting over public Wi-Fi access points.
    • PPPoE: For fixed home fiber or wireless CPE accounts requiring a dedicated username and password.
  4. Enter your package specifications:
    • Package Name: A clear label customers will recognize (e.g., 3-Hour Unlimited Hotspot or 10 Mbps Monthly Home Fiber).
    • Price: The cost in your selected currency.
    • Speed Limit: Bandwidth limits formatted as upload/download (e.g., 5M/5M for 5 Mbps symmetrical).
    • Duration: How long the plan remains active (e.g., 3 Hours, 24 Hours, or 30 Days).
    • Device Limit: Maximum concurrent devices allowed (commonly 1 for hotspots or 1-3 for home fiber).
  5. Click Create Package to make it live.

Step 4: Provision your MikroTik router

Nukta connects to your MikroTik router over an encrypted WireGuard management tunnel and handles customer traffic via high-performance cloud RADIUS. No public IP address or port forwarding is required on your router.

  1. In your dashboard, open Devices → Mikrotiks.
  2. Click Add Router.
  3. Give your router a recognizable identity (e.g., Site 1 Gateway or Hostel Main hEX).
  4. Nukta will generate an instant, one-line RouterOS v7 provisioning command. Click Copy Command.
  5. Connect to your MikroTik router using WinBox or WebFig.
  6. Open Terminal on your router, paste the command, and press Enter.
  7. The script automatically creates the WireGuard tunnel interface, registers Nukta's cloud RADIUS servers, configures Hotspot walled garden rules, and sets up authentication profiles.
  8. Within 15 seconds, your router will establish a handshake with Nukta. In your dashboard, the router card will show a bright green Online status badge.
TIP

If your router does not come online within 30 seconds, ensure the router can resolve external domains (test by running /ping 8.8.8.8 in the MikroTik terminal) and that the system clock is synchronized via SNTP.

Step 5: Connect a test customer and verify live billing

Now verify that authentication and accounting work end-to-end:

For Hotspot Wi-Fi:

  1. Connect a phone or laptop to your MikroTik router's hotspot Wi-Fi interface.
  2. The branded Nukta captive portal will automatically pop up.
  3. Select your test package and complete a test payment via your enabled gateway, or enter a test voucher code created from Finance → Vouchers.
  4. Once completed, the device connects to the internet instantly.

For Home Fiber / PPPoE:

  1. In your dashboard, open Users → Customers.
  2. Click Add Customer, enter the customer's name, phone number, and assign the package you created in Step 3.
  3. A unique customer username (e.g., S102) and account PIN are generated automatically.
  4. Configure a client router or laptop with this PPPoE username and password.
  5. The connection will dial up and authenticate immediately.

Confirm live session visibility:

Open Users → Active Users. You will see your test device listed with its MAC address, IP address, connection uptime, and real-time upload and download speeds streaming live.

Step 6: Configure automated billing and notifications

To automate renewals and keep customers informed:

  1. Payment Gateways: Open Settings → Payments. Connect your preferred payment provider—such as Paystack for card and bank payments, Kopo Kopo, or direct mobile money—to automate customer renewals. Nukta generates and handles callback URLs automatically.
  2. SMS Gateway: Open Settings → SMS Gateways. Choose your provider (such as Africa's Talking, Advanta, or Twilio), paste your API key, and specify your approved Sender ID.
  3. Automated Templates: Open Settings → SMS Templates. Review and customize pre-built templates for payment receipts, customer credentials, and renewal reminder notices sent prior to expiration.

Quickstart readiness checklist

Before onboarding paying customers in production, confirm these essential checks:

  • Account Security: Unique administrator password set and Two-Factor Authentication (2FA) enabled under Settings.
  • ISP Identity: Company branding, logo, support phone, and business timezone confirmed.
  • Active Packages: At least one live Hotspot or PPPoE package created with correct speed and duration limits.
  • Router Status: MikroTik router is showing green and "Online" in Devices → Mikrotiks.
  • Active Sessions: A test device successfully connected and appeared in Users → Active Users.
  • Payment Automation: A live test payment completed and connected the internet automatically without manual team intervention.
  • SMS Alerts: A test SMS receipt delivered successfully to your mobile phone.
  • Captive Portal: Captive portal displays your ISP logo and correct packages when devices join Wi-Fi.
nukta.one
On this page