Thox.ai - AI-Powered Edge Computing for Developers

Wi-Fi setup and troubleshooting

Setting up Wi-Fi

You can configure Wi-Fi through the CLI or web interface. Using CLI: thox wifi setup --ssid "YourNetwork" --password "YourPassword"

Scanning for networks

To see available networks: thox wifi scan. This lists all visible Wi-Fi networks with signal strength.

Common Wi-Fi issues

•Wrong password: Double-check your Wi-Fi password, including special characters
•Weak signal: Move the device closer to your router or use Ethernet instead
•5GHz not connecting: Some devices have limited 5GHz range, try 2.4GHz
•Hidden network: Use --hidden flag when connecting to hidden SSIDs

Checking Wi-Fi status

Run: thox wifi status. This shows connection status, signal strength, IP address, and network details.

Resetting Wi-Fi

To clear all Wi-Fi settings and start fresh: thox wifi reset. The device will fall back to Ethernet if connected.

Ethernet configuration

Default behavior

Ethernet is enabled by default and uses DHCP to automatically obtain an IP address from your router. No configuration is typically needed.

Speed negotiation

The device supports 10/100/1000/2500 Mbps and auto-negotiates the fastest supported speed. Check speed: thox network status

Ethernet vs Wi-Fi

We recommend Ethernet for: initial setup, firmware updates, and the best performance. Ethernet provides lower latency and more reliable connectivity.

Troubleshooting

•No link light on device or router: Try a different cable
•Link but no IP: Check router DHCP server is enabled
•Slow speeds: Verify cable is Cat5e or better for gigabit speeds
•Intermittent connection: Check cable connections at both ends

Setting a static IP address

Why use static IP?

A static IP ensures your device always has the same address, which is useful for bookmarks, scripts, and firewall rules.

Configuration via CLI

Configure static IP: thox network config --ip 192.168.1.100 --gateway 192.168.1.1 --dns 8.8.8.8

Configuration file

# /etc/thox/network.yaml
ethernet:
  dhcp: false
  ip: 192.168.1.100
  netmask: 255.255.255.0
  gateway: 192.168.1.1
  dns:
    - 8.8.8.8
    - 8.8.4.4

Reverting to DHCP

To switch back to automatic IP assignment: thox network config --dhcp

Avoiding conflicts

Make sure your static IP is outside your router's DHCP range to prevent conflicts with other devices.

DNS and mDNS settings

What is mDNS?

mDNS (multicast DNS) allows you to access your device as thox.local without knowing its IP address. It's supported on most modern operating systems.

mDNS requirements

•macOS: Built-in support (Bonjour)
•Windows: May require Bonjour Print Services installation
•Linux: Install avahi-daemon
•Network: mDNS traffic (port 5353) must not be blocked

Changing the hostname

To use a different hostname: thox config set hostname mydevice. The device will then be reachable at mydevice.local.

Custom DNS servers

Configure DNS servers: thox network config --dns "8.8.8.8,8.8.4.4" or edit /etc/thox/network.yaml

Troubleshooting mDNS

If thox.local doesn't resolve, try: 1) Use the IP address directly, 2) Check firewall allows UDP 5353, 3) Ensure you're on the same network, 4) Verify mDNS client is installed.

Connectivity