NettPortal
Documentation

Documentation

Frequently Asked Questions

This FAQ covers common questions about NettPortal, including router management, vouchers, packages, customers, payments, captive portal, and more. If you can't find the answer you're looking for, please refer to the detailed documentation pages or contact support.

General Questions

What is NettPortal?

NettPortal is a comprehensive network management platform for MikroTik routers. It allows you to manage routers, create vouchers, manage packages, handle customers, process payments, configure captive portals, and much more—all from a single web interface. It's designed to simplify network management for ISPs, WiFi providers, and network administrators.

What routers does NettPortal support?

NettPortal supports all MikroTik routers running RouterOS. The router must have the API service enabled (port 8728 for API or 8729 for API-SSL) and be accessible from your network. The system works with any RouterOS version that supports the API protocol.

Do I need to install anything on my routers?

No, you don't need to install anything on your routers. NettPortal connects to routers via the RouterOS API, which is built into all MikroTik routers. You just need to ensure the API service is enabled and accessible from your network. The system uses WireGuard for secure remote connections when needed.

How secure is NettPortal?

NettPortal uses industry-standard security practices. All passwords are encrypted, API connections can use SSL/TLS, and the system supports WireGuard VPN for secure remote access. Router passwords are encrypted in the database, and all API communications are secured. The system also includes role-based access control for employees.

Can I manage multiple routers?

Yes! NettPortal is designed to manage multiple routers. You can add as many routers as you need, and you can apply settings to multiple routers simultaneously. This makes it perfect for managing large networks with many routers.

Router Management

How do I add a router to NettPortal?

To add a router, navigate to Routers from the main menu and click Add Router. Enter the router's IP address, port (8728 for API or 8729 for API-SSL), username, and password. The system will test the connection before adding the router. Make sure the router's API service is enabled and accessible from your network.

Why is my router showing as disconnected?

A router may show as disconnected if it's offline, unreachable, or if there's a connection issue. Check that the router is online, the IP address is correct, the API service is enabled, and the router is accessible from your network. You can click the health check button to verify the connection. Firewall rules on the router may also be blocking API access.

Can I apply settings to multiple routers at once?

Yes! When configuring router settings, you can select multiple routers and apply the same settings to all of them simultaneously. This is perfect for bulk configuration changes, network-wide updates, or applying standard settings across your entire router fleet. The system will show you a summary of what will be applied to each router before confirming.

What happens if I reboot a router?

When you reboot a router, it will restart and may be offline for a few minutes. All active users will be disconnected during the reboot. The router will come back online automatically, and NettPortal will detect when it's back online. Make sure to reboot during maintenance windows or when it's safe to interrupt service.

Can I import existing users from my router?

Yes! You can import existing PPPoE and Hotspot users from a router into NettPortal. Click the Import Users button on a router card, select which service types to import (PPPoE, Hotspot, or Both), and the system will create customer accounts for imported users. Users that already exist (matched by username or email) will be skipped.

Vouchers

What is a voucher?

A voucher is a unique code (like NET-1234-ABCD) that users can redeem to get internet access. When someone redeems a voucher, NettPortal automatically creates a Hotspot user account on your MikroTik router with the voucher's settings (time limits, data limits, speed, and assigned profile). Vouchers are ideal for temporary access, guest networks, events, or any scenario where you need to give someone internet access without setting up a permanent customer account.

How do I create vouchers?

Navigate to Vouchers from the main menu and click Generate Vouchers. Select a router, choose the number of vouchers to create, set the voucher prefix and code length, configure time and data limits, select a profile, and click Generate. You can create one voucher or generate multiple vouchers at once with the same settings.

How do users redeem vouchers?

Users can redeem vouchers through the captive portal login page (if voucher purchase is enabled) or through the customer portal. When a user redeems a voucher, NettPortal automatically creates a Hotspot user account on the router with the voucher's settings. The user receives a username and password to connect to the WiFi network.

Can I set expiration dates for vouchers?

Yes! When creating vouchers, you can set validity dates to control when vouchers become active and when they expire. Vouchers can only be redeemed during their validity period. This is perfect for time-limited promotions, event-specific access, or scheduled distribution.

What happens when a voucher is redeemed?

When a voucher is redeemed, NettPortal automatically creates a Hotspot user account on the router with the voucher's settings. The system creates an offline payment record (if the voucher was purchased), and the user receives a username and password to connect to the WiFi network. The voucher is marked as redeemed and cannot be used again.

Packages

What is a package?

A package is a predefined internet service plan that customers can purchase. Packages include settings like time limits, data limits, speed limits, and assigned profiles. When a customer purchases a package, NettPortal automatically creates a voucher with the package's settings. Packages make it easy to offer standardized service plans to customers.

How do I create a package?

Navigate to Packages from the main menu and click Create Package. Enter the package name, price, description, configure time and data limits, set speed limits, select a profile, choose a router, and click Create. Packages can be active or inactive, and you can edit them at any time.

Can customers purchase packages themselves?

Yes! If you enable package purchases in your settings, customers can browse and purchase packages through the customer portal. When a customer purchases a package, NettPortal automatically creates a voucher with the package's settings and processes the payment. The customer receives a voucher code and can redeem it to get internet access.

Can I assign packages to customers manually?

Yes! Operators can assign packages to customers manually from the customer details page. Navigate to a customer's details page, go to the Actions tab, select a package, and click Assign Voucher. The system will create a voucher with the package's settings and assign it to the customer. This is useful for customer service or manual account setup.

Customers

How do I add a customer?

Navigate to Customers from the main menu and click Add Customer. Enter the customer's information (name, email, phone, address), set the service type (PPPoE, Hotspot, or Both), and click Create. The system will create a portal user account for the customer, and you can assign packages or vouchers to them later.

What's the difference between a Customer and a User?

A User is a portal user account (for logging into the customer portal), while a Customer is a router user account (for connecting to the router). When you create a customer, NettPortal automatically creates a portal user account. Customers can have router users created on routers when vouchers are assigned or when router users are created manually.

Can I pause or resume a customer's service?

Yes! You can pause or resume a customer's router user account from the customer details page. Navigate to a customer's details page, go to the Actions tab, and click Pause Customer or Resume Customer. This requires a router user to be created for the customer first. Pausing disables the router user account, and resuming enables it again.

How do I view a customer's vouchers and payments?

Navigate to a customer's details page and you'll see tabs for Overview, Vouchers, and Actions. The Overview tab shows payment history and support tickets. The Vouchers tab shows all vouchers assigned to the customer. You can also see transaction logs in the Transaction Logs page.

Payments & Transactions

What types of payments does NettPortal support?

NettPortal supports two types of payments: Offline Payments (when users activate vouchers on routers) and Online Payments (to be implemented). Offline payments are automatically recorded when vouchers are redeemed on routers. You can view all transactions in the Transaction Logs page.

How are offline payments recorded?

Offline payments are automatically recorded when vouchers are redeemed on routers. When a user activates a voucher on a router, the system creates a payment record with the voucher's price, customer information, and MAC address. These payments appear in the Transaction Logs page with the source marked as "Voucher (Offline)".

Can I filter transactions by date, status, or router?

Yes! The Transaction Logs page includes filters for date range (today, last 7 days, last 30 days, custom range), status (all, pending, completed, failed), source (all, voucher, invoice), payment method (all, offline, online), and router. You can use these filters to find specific transactions quickly.

Captive Portal

What is a captive portal?

A captive portal is the login page that users see when they connect to your WiFi network. It's the page that appears before users can access the internet. NettPortal allows you to customize this page with your branding, logo, colors, and even enable voucher purchases directly from the login page.

How do I configure the captive portal?

Navigate to a router's details page and click on the Captive Portal tab. Select a template from the available options, customize the configuration (organization name, theme color, logo, portal URL, voucher purchase enabled/disabled), preview the portal, save the configuration, and then push it to the router. The captive portal will be deployed to the router's Hotspot HTML directory.

Can users purchase vouchers from the captive portal?

Yes! If you enable voucher purchase in the captive portal configuration, users will see a "Purchase Voucher" option on the login page. They can browse available packages, purchase vouchers, and redeem them immediately to get internet access. This is perfect for self-service WiFi access.

What templates are available?

NettPortal includes several pre-designed templates: Classic Gradient, Minimal Clean, Animated Gradient, Card Elevated, Centered Modern, and Split Layout. Each template has a different design and layout. You can customize any template with your branding, logo, and colors.

Profiles

What is a profile?

A profile is a RouterOS profile (PPPoE or Hotspot) that defines connection settings like time limits, data limits, speed limits, and other restrictions. Profiles are created on routers and can be assigned to vouchers, packages, and customers. Profiles make it easy to manage connection settings across multiple users.

How do I create a profile?

Profiles are created on routers using RouterOS. NettPortal can sync profiles from routers, or you can create them manually on routers. Once created, profiles appear in NettPortal and can be assigned to vouchers, packages, and customers. You can also create profiles through the Router Settings page.

Can I sync profiles from routers?

Yes! NettPortal can automatically sync profiles from routers. When you create a voucher or package, the system loads available profiles from the selected router. You can also manually sync profiles by refreshing the profile list in the Router Settings page.

Troubleshooting

I can't connect to my router. What should I do?

First, verify the router is online and accessible. Check the IP address, port (8728 for API or 8729 for API-SSL), username, and password. Ensure the API service is enabled on the router and that firewall rules allow API access. Try using the "Test Connection" button when adding or editing a router. If the connection still fails, check router logs and network connectivity.

Settings aren't applying to my router. What's wrong?

Check that the router is connected and online. Review error messages in the summary modal after applying settings. Use the "Auto-Fix Warnings" button if available. Verify the router has sufficient resources (memory, CPU). Check router logs for errors. Some settings may require specific RouterOS versions or configurations.

Vouchers aren't being created on the router. Why?

Ensure the router is connected and online. Check that the Hotspot server is enabled and configured on the router. Verify the selected profile exists on the router. Check router logs for errors. Make sure the router has sufficient resources. Some voucher settings may require specific RouterOS configurations.

The captive portal isn't displaying. How do I fix it?

Verify the captive portal was pushed to the router. Check that the Hotspot server is enabled and configured. Verify the Hotspot profile HTML directory is correct. Check router logs for errors. Test with a different device or browser. Ensure the router's Hotspot server is serving the correct HTML directory.

Users can't connect to the WiFi. What should I check?

Check that the wireless interface is enabled and configured correctly. Verify the SSID and security settings (WPA2/WPA3 passphrase). Ensure the Hotspot server is enabled and configured. Check that IP pools are configured correctly. Verify DHCP server is enabled and working. Check router logs for connection errors. Ensure the bridge interface includes the wireless interface.

Need More Help?

If you can't find the answer you're looking for, check out the detailed documentation pages:

Faq - Documentation - NettPortal