Wi-Fi and Network Configuration
Configure wireless connectivity and network settings for your Thox.ai device.
While Ethernet is recommended for best performance, Wi-Fi provides flexibility for device placement. This guide covers both web-based and CLI configuration methods.
Prerequisites
- Device is powered on and showing green LED
- Initial setup completed via Ethernet (recommended)
- Wi-Fi network name (SSID) and password ready
- Wi-Fi network is 2.4GHz or 5GHz (both supported)
Method 1: Web Interface
Step 1: Access Network Settings
Navigate to http://thox.local:8080/admin/network in your browser. Log in with your admin credentials.
Step 2: Scan for Networks
Click "Scan for Wi-Fi Networks". The device will scan and display available networks. This takes 10-15 seconds.
Step 3: Connect to Network
Click on your network name, enter the password, and click "Connect". The device will attempt to connect and show status.
Step 4: Verify Connection
Once connected, the page will show the Wi-Fi IP address. You can disconnect Ethernet and access the device via the Wi-Fi IP.
Method 2: Command Line
Scan for Networks
Connect to Network
Check Connection Status
Disconnect from Wi-Fi
Advanced Configuration
Static IP Configuration
Assign a static IP address for consistent access:
Enterprise Wi-Fi (WPA2-Enterprise)
Connect to enterprise networks with username/password:
Hidden Networks
Connect to networks that don't broadcast their SSID:
Troubleshooting
Network not appearing in scan
- • Ensure the network is broadcasting (not hidden)
- • Move the device closer to the router
- • Try scanning again - some networks take multiple attempts
- • Check if the network uses a supported security type (WPA2/WPA3)
Connection fails with correct password
- • Verify password has no typos (case-sensitive)
- • Check for special characters that need escaping in CLI
- • Restart the router and try again
- • Some routers have MAC address filtering - add device MAC
Connected but no internet
- • Check DNS settings:
thox network status - • Try setting DNS manually to 8.8.8.8
- • Verify router is connected to internet
- • Check if a captive portal requires authentication
Performance Tips
- Use 5GHz when possible for lower latency and better throughput
- Position wisely - clear line of sight to router improves signal
- Avoid interference from microwaves, Bluetooth devices, and other 2.4GHz equipment
- Consider Ethernet for latency-critical development work