Troubleshooting

Router Shows Offline

1. Check if the router has internet access

2. Verify the WireGuard tunnel is active

3. Check if the API service is running on the router:

   /ip service print
   

4. Ensure API port (8728) is accessible from our VPS

5. Try re-onboarding from the dashboard

Provisioning Script Fails

Common errors and solutions:

Error

Solution

failure: already have interface

Router was already provisioned. Run the script again or reset config first

failure: address already added

Clear existing configuration or use a fresh router

certificate expired

Update RouterOS to latest version

no route to host

Check internet connectivity and firewall rules

High Latency

If router latency is consistently high (>200ms):

1. Check the router's CPU load

2. Verify the internet connection quality

3. Check for bandwidth saturation on the WAN link

4. Consider upgrading the router hardware

Session Issues

If sessions are not showing up:

1. Verify RADIUS is configured correctly:

   /radius print
   

2. Check that accounting is enabled

3. Verify the router can reach our RADIUS servers

4. Check firewall rules aren't blocking RADIUS ports (1812, 1813)