Skip to main content
Documentation
Getting StartedSettings

System and Workspace Settings

Complete reference for configuring your ISP workspace, network policies, payment gateways, SMS templates, and administrator security.

Configure your ISP workspace

Account-wide settings in Nukta control your business identity, network automation policies, payment gateway connections, and team security. These controls are reserved for the ISP Owner and administrator accounts to ensure system stability.

Settings overview map

The settings workspace (Settings) is organized into six functional areas:

CategoryPageWhat it controls
GeneralBrandingNetwork display name, logo upload, brand theme color, country, operating timezone, currency code, support contact channels, and captive portal Terms & Conditions.
GeneralDomainWorkspace subdomain prefix ({prefix}.nukta.one) and domain update workflow.
NetworkPPPoEInactive customer pruning, pre-expiry reminder SMS schedule, automated monthly invoice generation, and invoice number prefix.
NetworkHotspotCaptive portal template selection, custom background image, post-login redirect URL, portal sections, username format prefix, and voucher expiry rules.
FinancePaymentsPayment gateway credentials (Paystack, Kopo Kopo, or mobile money), automated callback URLs, and readiness tests.
CommunicationSMS GatewaysSMS provider connection (Africa's Talking, Advanta, Twilio, or generic HTTP SMS), API credentials, and approved Sender ID.
CommunicationSMS TemplatesAutomated message templates for payment receipts, hotspot voucher delivery, PPPoE renewal notices, and pre-expiry reminder alerts.
NotificationsOperator AlertsAdministrative notification recipients for router disconnects, payment callback errors, and daily morning revenue summaries.
PersonalMy ProfileThe signed-in user's full name, email address, and phone number.
PersonalSecurity & 2FAPassword management and Two-Factor Authentication (2FA) authenticator app setup.

General settings

Branding (Settings → Branding)

Configure the visual and corporate identity shared across your administrative dashboard, customer captive portals, and payment receipts:

  • ISP Network Name: The legal or trade name your customers recognize. Appears on Wi-Fi captive portals, payment receipts, and SMS messages.
  • Logo: Upload your high-resolution company logo in PNG, SVG, or WebP format. Displayed prominently on hotspot login screens and invoice headers.
  • Brand Accent Color: Select a theme color that reflects your company brand. This styles primary action buttons, active navigation indicators, and captive portal cards.
  • Country, Timezone & Currency:
    • Country: Sets your primary operating country.
    • Timezone: Anchors all session timeouts, automated invoice generation, and financial charts to your selected operating timezone.
    • Currency: Standard 3-letter currency code for your operating market (e.g., KES, USD, NGN).
  • Support Contact Details:
    • Support Phone: Public telephone number shown on captive portals and payment receipts so customers can reach your helpdesk easily.
    • Support Email: Official customer service email displayed on invoices and correspondence.
  • Terms & Conditions: Rich text editor for your public terms of service. When enabled, walk-in hotspot users must accept these terms before purchasing a plan.

Domain (Settings → Domain)

Manages your dedicated workspace subdomain:

https://{subdomain}.nukta.one

Before confirming a subdomain change in production:

  1. Notify team members who have bookmarked the existing URL.
  2. Update external payment provider dashboards if you registered the previous URL as your primary callback domain.
  3. Test customer captive portals and router downloads under the new address.

Network settings

PPPoE automation (Settings → Network → PPPoE)

Controls automated lifecycle processing for fixed home fiber and wireless CPE accounts:

  • Inactive Customer Pruning: Automatically archive customer accounts that have remained expired for a configurable period (e.g., 90 days) to keep your active customer database clean.
  • Pre-Expiry Reminder Alerts: Schedule automated SMS reminders sent to customers (e.g., 24 hours or 3 days before their plan expires) encouraging timely renewals.
  • Automatic Invoicing: Automatically generate monthly invoices for recurring PPPoE customers prior to their renewal date.

Hotspot & captive portal (Settings → Network → Hotspot)

Customizes the walk-in customer Wi-Fi experience:

  • Portal Template: Choose between clean modern layout themes optimized for smartphones, tablets, and laptops.
  • Custom Background Wallpaper: Upload a custom high-resolution background image.
  • Post-Login Redirect URL: The web page opened automatically after a customer successfully authenticates (e.g., your ISP website or a local news portal).
  • Portal Sections: Show or hide specific components on the captive login screen, such as the Package List, Voucher Code Input Box, or Customer Support Contacts.
  • Username Format Prefix: Custom prefix prepended to auto-generated hotspot customer usernames (e.g., H for H101, H102).
  • Unused Voucher Expiry: Maximum validity period before an unredeemed voucher code automatically expires.

Finance settings

Payments & gateways (Settings → Payments)

Nukta integrates with leading regional and international payment processors to automate customer activations and renewals:

  • Paystack: Accepts international debit and credit cards (Visa, Mastercard, Verve), direct bank accounts, and mobile wallets across Africa and worldwide. Requires Public Key and Secret Key.
  • Kopo Kopo: Real-time merchant processing for Till numbers and mobile STK pushes. Requires STK Till Number, API Key, Client ID, and Client Secret.
  • Mpesa: Automated billing via STK push, merchant Paybill, or Buy Goods Till. Supports direct settlement to bank accounts across 30+ supported commercial banks. Requires Consumer Key, Consumer Secret, Passkey, and Shortcode / Till Number.
  • Manual Payments & Vouchers: Record cash collections directly at your customer service counter or sell physical voucher cards created in Finance → Vouchers.
  • Readiness Verification: Click Test Connection to authenticate your credentials before routing live customer payments.

Communication settings

SMS gateways (Settings → Communications → SMS Gateways)

Connect your bulk SMS provider to deliver receipts, login credentials, and renewal alerts:

  • Supported Gateways: Africa's Talking, Advanta SMS, Twilio, or custom HTTP SMS endpoints.
  • API Credentials: Enter your API username, API key, and approved Sender ID (e.g., MTAANINET).
  • Balance Check: Displays your live SMS credit balance directly inside the dashboard.

SMS templates (Settings → Communications → SMS Templates)

Customize the automated text messages sent to customers. Each template supports dynamic variables:

  • Payment Receipt Template: Sent immediately after an online payment is confirmed. 
    Confirmed! We received {{currency}} {{amount}} for {{package_name}}. Ref: {{receipt_number}}. Valid until {{expiry_date}}. Thank you for choosing {{provider_name}}!
  • Hotspot Voucher Delivery: Delivers generated voucher codes to customers. 
    Your {{provider_name}} Wi-Fi voucher code is: {{voucher_code}}. Connect to our hotspot and enter this code to start browsing.
  • PPPoE Renewal Notice: Confirms home fiber extension.
  • Pre-Expiry Reminder: Sent before a customer's package expires to encourage uninterrupted renewal.

Supported template variables:

  • {{customer_name}} — Customer's name
  • {{package_name}} — Name of the purchased internet plan
  • {{expiry_date}} — Formatted expiration date and time
  • {{amount}} — Transaction amount
  • {{currency}} — Three-letter currency code (e.g., KES, USD, NGN)
  • {{receipt_number}} — Payment gateway transaction reference
  • {{provider_name}} — Your ISP display name
  • {{voucher_code}} — Generated voucher PIN

Notifications & alerts

Operator alerts (Settings → Notifications → Operator Alerts)

Configure administrative notifications so your engineering and operations teams are alerted during critical events:

  • Router Disconnect Alerts: Receive immediate SMS or email notifications if a MikroTik router misses consecutive heartbeats and goes offline.
  • Daily Revenue Summaries: Automatically receive a morning summary of yesterday's total collections, new customer signups, and active package counts.
  • Recipient List: Add mobile phone numbers and email addresses of administrators who should receive these alerts.

Personal account settings

My profile (Settings → Account → My Profile)

Update your personal administrator identity:

  • First and last name.
  • Work email address.
  • Contact telephone number.

Security and 2FA (Settings → Account → Security & 2FA)

Protect your administrator account against unauthorized access:

  • Password Change: Update your login password with strength validation.
  • Two-Factor Authentication (2FA): Connect an authenticator app (such as Google Authenticator, Authy, or 1Password) using a QR code. When enabled, signing in requires your password plus a 6-digit time-based one-time password (TOTP).

Safe change procedure for administrators

When adjusting settings that affect live money, network access, or custom domains:

  1. Document Current Values: Record the existing configuration before editing credentials or policies.
  2. Make One Change at a Time: Avoid changing multiple gateways or network timers simultaneously.
  3. Verify with a Controlled Test: After saving payment or SMS credentials, execute a small test transaction or send a single test SMS before rolling out to customers.
  4. Inspect Live Logs: Check Users → Active Users or Communication → Messages to confirm that requests are resolving cleanly.
nukta.one
On this page