Troubleshooting

Symptoms

• •Cannot reach thox.local
• •Device not visible in router's DHCP list
• •No response from IP address

Solutions

1. 1Ensure the Ethernet cable is securely connected to both the device and router
2. 2Wait 2-3 minutes after power-on for the device to fully boot
3. 3Try connecting to the device via IP address instead of hostname
4. 4Check if your router supports mDNS (Bonjour) - if not, use IP address
5. 5Restart your router and the Thox device
6. 6Try a different Ethernet port on your router

Symptoms

• •API requests take longer than expected
• •Streaming feels laggy
• •High latency between tokens

Solutions

1. 1Check device temperature with `thox status` - thermal throttling occurs above 80°C
2. 2Ensure adequate ventilation around the device
3. 3Try a smaller/faster model (e.g., switch from thox-coder-large to thox-coder)
4. 4Use quantized models (q4_k_m instead of fp16) for faster inference
5. 5Reduce context length if not needed: set max_tokens to a reasonable limit
6. 6Close other applications using the device

Symptoms

• •Error: "Model not found"
• •Error: "Insufficient memory"
• •Device becomes unresponsive after model selection

Solutions

1. 1Verify the model is installed with `thox models list`
2. 2Check available memory with `thox status`
3. 3Unload current model before loading a new one: `thox models unload`
4. 4Try a smaller quantization: `thox models pull model-name:q4_0`
5. 5Restart the device: `thox system restart`
6. 6Clear model cache: `thox system clear-cache`

Symptoms

• •Error: "Connection refused"
• •Error: "ECONNREFUSED"
• •Cannot connect on port 8080

Solutions

1. 1Check if the device is powered on (LED should be green)
2. 2Verify the correct port (default is 8080)
3. 3Ensure no firewall is blocking the connection
4. 4Wait for the device to fully boot (green LED)
5. 5Try restarting the API service: `thox service restart`
6. 6Check device logs: `thox logs --tail 50`

Symptoms

• •Cannot connect to Wi-Fi network
• •Wi-Fi keeps disconnecting
• •Slow Wi-Fi speeds

Solutions

1. 1Ensure correct SSID and password
2. 2Move the device closer to your router
3. 3Try the 5GHz band instead of 2.4GHz for better speeds
4. 4Check for interference from other devices
5. 5Update the Wi-Fi firmware: `thox system update --wifi`
6. 6Reset Wi-Fi settings: `thox wifi reset`