Troubleshooting

Check the power adapter

Ensure you're using the included 65W USB-C adapter or a compatible USB-C PD charger. The device requires at least 45W to operate.

Try a different outlet

Test the power outlet with another device. If using a power strip, try plugging directly into a wall outlet.

Inspect the USB-C cable

Check the cable for damage. Try a different USB-C cable rated for power delivery (PD).

Perform a hard reset

Hold the reset button (small hole on back) for 10 seconds with a paperclip while unplugged, then reconnect power.

Check for overheating

If the device feels hot, unplug and let it cool for 15 minutes. Ensure proper ventilation around the device.

Verify physical connection

Check that the Ethernet cable is firmly connected at both ends. Try a different cable if available.

Check LED status

A blue LED indicates network activity. If the LED is red, there may be an error - check the logs.

Use IP instead of hostname

If thox.local doesn't work, check your router's DHCP client list for the device IP and access it directly (e.g., http://192.168.1.xxx:8080).

Restart your router

Power cycle your router and wait 2-3 minutes before testing the connection again.

Check firewall settings

Ensure your computer's firewall allows connections to port 8080. On some networks, mDNS may be blocked.

Check device temperature

Run "thox status" to check temperature. If above 75°C, the device may be thermal throttling. Improve ventilation or reduce workload.

Use a smaller model

Try switching to a smaller/faster model like thox-coder instead of thox-coder-large. Run "thox models list" to see options.

Reduce context length

Shorter prompts and conversation history result in faster processing. Consider clearing context periodically.

Use quantized models

Download q4_k_m quantized versions for faster inference: "thox models pull thox-coder:q4_k_m"

Check for background tasks

If a model is being downloaded or the device is updating firmware, performance may be temporarily reduced.

Verify the device is ready

The LED should be solid green. If it's a different color, wait for initialization to complete.

Check the port number

The default API port is 8080. Verify your requests are going to http://thox.local:8080/v1/...

Test with curl

Run: curl http://thox.local:8080/health - You should get {"status": "healthy"}.

Restart the API service

Run "thox service restart" from the CLI or reboot the device.

Check the logs

Run "thox logs --tail 50" to see recent error messages that may indicate the issue.