Getting Started
Everything you need to set up your Thox.ai device and start using it.
Popular Articles
Unboxing and package contents
What to expect when your Thox.ai device arrives.
Package contents
Your Thox.ai package includes: the Thox.ai device, 65W USB-C power adapter, Ethernet cable (1m), Quick Start Guide, and warranty card.
Checking your device
Inspect the device for any visible damage. The aluminum enclosure should be free of dents or scratches. Check that all ports (USB-C, Ethernet, USB-A) are clear and undamaged.
Package registration
Register your device at thox.ai/register using the serial number on the bottom of the device. This activates your warranty and enables firmware updates.
Setting up your device for the first time
Step-by-step guide to get your device up and running.
Choose a location
Place your Thox.ai device on a flat, stable surface with good ventilation. Ensure at least 2 inches of clearance on all sides. Avoid enclosed spaces, direct sunlight, and areas near heat sources.
Connect power
Connect the included 65W USB-C power adapter. The device requires USB-C Power Delivery (PD) with 45-65W. Third-party adapters meeting these specs will work, but the included adapter is recommended.
Network connection
For initial setup, we recommend Ethernet. Connect the included cable to your router. Wi-Fi can be configured later through the web interface or CLI.
Boot sequence
The LED indicates status: White pulsing (booting), Yellow (initializing), Blue (network config), Green solid (ready). First boot takes 60-90 seconds.
Connecting to your network
Configure Ethernet and Wi-Fi connectivity.
Ethernet (recommended)
Simply plug in the Ethernet cable. The device uses DHCP by default and will automatically obtain an IP address from your router.
Finding your device
Access via http://thox.local:8080 (requires mDNS/Bonjour support) or check your router's DHCP client list for the device IP.
Wi-Fi configuration
After initial Ethernet setup, configure Wi-Fi via the web interface at /admin/network or CLI: thox wifi setup --ssid "NetworkName" --password "Password"
Static IP (optional)
For static IP: thox network config --ip 192.168.1.100 --gateway 192.168.1.1 --dns 8.8.8.8 --dns 8.8.4.4
Connecting your development environment
Set up VS Code, JetBrains, and other IDEs.
VS Code extension
Search "Thox.ai" in the Extensions marketplace and install. Configure the host (thox.local or IP) and port (8080) in settings. Test connection via Command Palette > "Thox: Test Connection".
JetBrains plugin
Install from JetBrains Marketplace. Go to Settings > Tools > Thox.ai to configure. The plugin supports IntelliJ, PyCharm, WebStorm, and other JetBrains IDEs.
Vim/Neovim
Install thox.nvim via your plugin manager. Add to config: require("thox").setup({ host = "thox.local", port = 8080 })
Other editors
Thox.ai exposes an OpenAI-compatible API at http://thox.local:8080/v1. Any editor supporting OpenAI's API can be configured to use Thox.ai.
Using the web interface
Navigate the admin dashboard and settings.
Accessing the dashboard
Navigate to http://thox.local:8080/admin. Default credentials are admin/admin. You'll be prompted to change these on first login.
Dashboard overview
The main dashboard shows system status, active model, memory usage, and recent requests. Real-time metrics update every 5 seconds.
Model management
The Models section lets you view installed models, download new ones, and set the active model. Popular models include thox-coder, llama3, and codestral.
Settings
Configure network, security, performance tuning, and integrations. Changes take effect immediately for most settings; some require a restart.