> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centipidbilling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Provision a router

> Register a MikroTik NAS, run the generated command, and configure PPPoE and Hotspot services.

# Provision a MikroTik router

The provisioning wizard links a router to the current ISP account, detects the created NAS, and then applies selected service configuration. Use a router you are authorized to manage and schedule production changes appropriately.

## Prerequisites

* The router can reach the internet and resolve required service hostnames.
* RouterOS and hardware are compatible with the generated script shown by this application version.
* You can open the MikroTik terminal with sufficient privileges.
* The router clock, DNS, firewall, and outbound HTTPS are not intentionally blocking provisioning.
* You know which physical ports/bridge should serve Hotspot and PPPoE users.

## Complete the wizard

<Steps>
  <Step title="Create the NAS record">
    Open **Network → Devices → Routers**, choose to add a router, and enter a recognizable identity such as the site and device role. Avoid generic names that become ambiguous in alerts.
  </Step>

  <Step title="Copy the generated command">
    Copy the entire provisioning command from the wizard. Do not edit embedded tokens, URLs, quoting, or arguments unless the product explicitly asks for a value.
  </Step>

  <Step title="Run it once in the MikroTik terminal">
    Paste the command, watch for RouterOS syntax/network errors, and let it finish. Do not publish the command or screenshot its secrets.
  </Step>

  <Step title="Wait for detection">
    Return to the wizard and wait for the connection-status step to detect the NAS. The wizard polls current state; leaving and returning to an already created NAS should reuse its progress rather than create another device.
  </Step>

  <Step title="Choose services and ports">
    Select PPPoE, Hotspot, or both as appropriate. Choose bridge/interface ports deliberately and enable anti-sharing only when it matches the Hotspot policy.
  </Step>

  <Step title="Configure and watch progress">
    Start service configuration and keep the progress/log view open. Configuration runs in the background. A completed NAS should report the enabled services and appear in the router inventory.
  </Step>

  <Step title="Verify end to end">
    Check status, router time, services, captive portal, RADIUS authentication/accounting, and one test subscriber. Do not rely on the wizard's final screen alone.
  </Step>
</Steps>

## If detection fails

1. Inspect the router terminal output for download, certificate, DNS, permission, or syntax errors.
2. Confirm the router was not already registered under another identity or ISP.
3. Check outbound access and WireGuard transport state.
4. Use the wizard's current status/log rather than rerunning the command repeatedly.
5. If a NAS record exists, open it and run diagnostics.
6. Capture sanitized error text, router identity, RouterOS version, and approximate time for support.

## If service configuration fails

Do not delete the NAS immediately. Review the configuration log and existing router services/bridges. Correct port selection or conflicting local configuration, then use the targeted setup/reprovision action indicated by the UI.

## After provisioning

* Set the router-specific support number and captive theme if needed.
* Confirm walled-garden access for the selected payment gateway.
* Add fallback RADIUS where offered and intended.
* Enable monitoring and review alert destinations.
* Create packages with deliberate NAS restrictions.
* Test reconnect behavior after a controlled router reboot only during an approved window.