Troubleshooting

Common issues and how to resolve them.

Login Failed / Wrong Password

The "Router Password" field expects the admin password for your router's web interface (typically accessed at 192.168.0.1). This is not the WiFi password.

If you've never changed it, try the default password printed on the router's label.

Connection Timeout

Ensure you are connected to the router's WiFi or Ethernet. The agent communicates directly with the router at the gateway IP (default: 192.168.0.1).

If you've changed the router's LAN IP, update the IP address in the companion app or API calls accordingly.

Agent Not Responding After Deploy

If the agent isn't reachable at port 9090:

Wait 5-10 seconds and try again
Check if the agent is running via SSH:

bash

ssh -p 2222 root@192.168.0.1 'ps | grep zte-agent'

If the process isn't running, check the boot script:

bash

ssh -p 2222 root@192.168.0.1 'cat /data/local/tmp/start_zte_agent.sh'
ssh -p 2222 root@192.168.0.1 'sh /data/local/tmp/start_zte_agent.sh'

CORS Errors

The zte-agent serves with permissive CORS headers by default. If you're seeing CORS errors, ensure you're connecting to the correct IP and port (9090), and that no proxy or VPN is interfering.