Setting up Wi-Fi in Hive OS — a critical step for those mining on rigs without wired connectivity. Unlike traditional operating systems, Hive OS Optimized for managing rigs and ASIC machines, its network settings often raise questions among beginners. Without a stable internet connection, the farm won't be able to sync with pools, update firmware, or transmit statistics to the web interface.
In this article we will analyze all the nuances: from choosing a compatible Wi-Fi adapter to fine-tuning network settings in the console. We'll pay special attention to typical errors that lead to connection drops or low speeds, as well as alternative connection methods (for example, via USB modem or ethernet-to-wifi Bridges). If you're experiencing issues with Hive OS not seeing your network or constantly losing connection, you'll find solutions here.
1. Compatible Wi-Fi adapters for Hive OS
Not everyone Wi-Fi adapter will work with Hive OS "out of the box". The operating system is based on Ubuntu Server and uses the kernel Linux, so it's critical to choose a device with driver support for this environment. Here are the key criteria:
- 🔌 Chipset: The best options are -
Ralink RT5370/RT5572,Atheros AR9271,Realtek RTL8188EU/RTL8812AUAvoid adapters onBroadcom- they often require manual installation of drivers. - 📶 Standard: Minimal
802.11n(2.4 GHz), but for stability it is better802.11ac(5 GHz). Adapters withWi-Fi 6(802.11ax) may not be supported. - 🔄 Opening hours: The adapter must support
client mode(and not onlyAP modefor distribution). - 💡 Nutrition: For USB adapters it is recommended to use powered USB-hub, as the motherboard ports may not provide enough current.
Among the tested models, the following stand out:
- 🛒 TP-Link TL-WN722N (chipset
Atheros AR9271) is a budget and reliable option. - 🛒 Alfa AWUS036ACH (chipset
RTL8812AU) - supports 5 GHz and has a removable antenna. - 🛒 Edimax EW-7811Un (chipset
RTL8188CUS) is compact, but only works at 2.4 GHz.
⚠️ Attention: Before purchasing, please check the current list of supported adapters in official Hive OS documentationManufacturers can change chipsets in the same model without notice.
2. Connecting the Wi-Fi adapter to the rig
Once you've selected the adapter, you need to connect it to the farm correctly. Here are the step-by-step instructions:
- Turn off the power to the rig. This will prevent damage to the USB ports or adapter.
- Connect the adapter to the motherboard's USB port. If you are using USB-hub, connect it to the port
USB 2.0(blue portsUSB 3.0may cause interference). - Connect the antenna (if it is removable). Make sure the connector is securely fastened.
- Turn on the rig's power and wait until it is fully loaded Hive OS.
To check if the system has recognized the adapter, run the following command in the console:
lsusb
Your adapter should appear in the output. For example, for TP-Link TL-WN722N this will be the line:
Bus 001 Device 003: ID 0cf3:9271 Atheros Communications, Inc. AR9271 802.11n
☑️ Checking the adapter connection
If the adapter is not displayed:
- 🔄 Try a different USB port.
- 🔌 Use powered USB-hub (lack of power is a common cause of problems).
- 🔧 Check the adapter on another device (PC/laptop).
3. Setting up Wi-Fi via the Hive OS web interface
The easiest way to set up Wi-Fi is through the control panel. Hive OSTo do this:
- Go to the section
Workersand select your rig. - Tab
Network→Wi-Fi. - Activate the switch
Enable Wi-Fi. - In the field
SSIDEnter your network name (case sensitive!). - Select the security type (
WPA2-PSK— the most common). - Enter the password in the field
Password. - Click
Save & Apply.
If the rig does not connect after saving:
- 🔍 Make sure your adapter is supported (see section 1).
- 📡 Check that the router does not hide the SSID (this option should be disabled in the router settings)
Hide SSID). - 🔄 Reboot the rig via the web interface (
Reboot).
| Parameter | Recommended value | Note |
|---|---|---|
Country Code |
US or your country |
Affects available Wi-Fi channels. |
Channel Width |
Auto or 20 MHz |
Width 40 MHz may cause interference. |
Security |
WPA2-PSK |
WPA3 may not be supported. |
DNS |
8.8.8.8 (Google) or 1.1.1.1 (Cloudflare) |
Helps avoid problems with name resolution. |
4. Setting up Wi-Fi via the console (for advanced users)
If the web interface doesn't help or you need more control, you can configure Wi-Fi manually via terminalTo do this:
- Connect to rig via
SSH(use data from the web interface Hive OS). - Edit the network configuration file:
sudo nano /hive-config/wpa_supplicant.conf
Add the following block to the file (replace your_ssid And your_password):
network={ssid="your_ssid"
psk="your_password"
key_mgmt=WPA-PSK
priority=1
}
Save changes (Ctrl+O, then Enter) and close the editor (Ctrl+X).
Restart the network service:
sudo systemctl restart networking
Check your connection status:
iwconfig
In the output, look for a line with your adapter (for example, wlan0) and parameter ESSID, which must match the name of your network.
⚠️ Attention: If after manual setup the rig has lost connection to the internet, connect to it vialocal network(wiredEthernet) and check the file syntaxwpa_supplicant.confA single character error (for example, an extra comma) will cause a crash.
5. Solving common Wi-Fi problems in Hive OS
Even after proper setup, problems may arise. Here are the most common ones and how to solve them:
| Problem | Possible cause | Solution |
|---|---|---|
| Hive OS doesn't detect Wi-Fi networks | The adapter is not supported or is disabled. | Check it out lsusb And dmesg | grep wifi. Try a different adapter. |
| Constant connection breaks | Weak signal or interference | Use 5 GHz or move the rig closer to the router. Check iwconfig for mistakes. |
| Slow internet speed | Channel congestion or incorrect router settings | Change the Wi-Fi channel in your router settings. Disable it. QoS. |
| Wi-Fi settings are not saved | Permission error or file system failure | Do it sudo chmod 600 /hive-config/wpa_supplicant.conf and reboot the rig. |
If the rig connects to Wi-Fi but cannot access the internet:
- Check your settings
DNSin the file/etc/resolv.conf:
nameserver 8.8.8.8
nameserver 1.1.1.1
- Make sure your router is turned on
DHCPor manually assign an IP address to the rig. - Check if your router is blocking your connection
MAC address(must be disabled in the router settings)MAC Filtering).
How to check Wi-Fi connection logs?
Run the command journalctl -u networking --no-pager | grep wlanLook for error lines in the logs. authentication failed or association failed - They will indicate a problem with the password or signal.
6. Alternative ways to connect to the Internet
If you're having trouble setting up Wi-Fi or your adapter isn't working, consider these alternatives:
- 🌐 USB modem (4G/5G):
- Modems are supported Huawei E3372, ZTE MF823 and others on chipsets
Qualcomm. - Insert the modem into the USB port and configure the connection in the section
Network → Mobile.
- Modems are supported Huawei E3372, ZTE MF823 and others on chipsets
- 🔗 Ethernet-to-WiFi bridge:
- Use devices like TP-Link TL-WR702N in mode
Client Mode. - Connect the bridge to the rig via
Ethernet, and the bridge itself is connected to the Wi-Fi network.
- Use devices like TP-Link TL-WR702N in mode
- 📡 Powerline adapters:
- Transmission of the Internet via electrical wiring (for example, TP-Link AV600).
- Suitable if the router is far away and it is impossible to lay a cable.
Important: USB modems can be blocked by your carrier if used intensively (mining consumes a lot of data). Before purchasing, check your plan—some carriers limit "unlimited" internet after 100–200 GB.
7. Optimizing Wi-Fi for Stable Mining
To ensure smooth farm operation, simply connecting to Wi-Fi isn't enough. Network optimization is essential:
- 📶 Channel and frequency:
- Use
5 GHzfor less interference (but remember that the signal at this frequency passes through walls worse). - In manual mode, select a channel with minimal load (check through applications like Wi-Fi Analyzer).
- Use
- 🔄 Power saving mode:
- Turn it off
Wi-Fi Power Savingin the adapter settings (if there is such an option). - IN Hive OS add in
/etc/rc.localline:
- Turn it off
iwconfig wlan0 power off
- 🛡️ Safety:
- Use
WPA2-PSKwith a complex password (at least 12 characters, with numbers and special characters). - Turn it off
WPSin the router settings - this is a vulnerability.
- Use
If you have multiple rigs on one farm connected via Wi-Fi:
- 🔗 Consider using
Wi-Fi Meshsystems (for example, Google Nest Wi-Fi or TP-Link Deco). - 📊 Set up
QoSon the router to limit traffic for other devices on the network.
FAQ: Frequently asked questions about setting up Wi-Fi in Hive OS
Can I use Wi-Fi 6 adapters with Hive OS?
Theoretically yes, but in practice most adapters Wi-Fi 6 (802.11ax) do not have drivers in the kernel Linux, which is used in Hive OSBefore purchasing, check the compatibility of a specific model on mining forums (for example, Official Hive OS forum).
If the adapter doesn't work out of the box, you can try compiling the driver manually, but this requires advanced knowledge. Linux.
How to reset network settings in Hive OS?
If you made a mistake in the settings and the rig lost connection, follow these steps:
- Connect to the rig via
Ethernet(temporarily). - In the web interface, go to
Workers → [your rig] → Network. - Click
Reset Network Settings. - Confirm the reset and reboot the rig.
If you don't have access to the web interface, connect via SSH and run:
sudo rm /hive-config/wpa_supplicant.conf
sudo reboot
Why does Hive OS see the network but not connect?
There may be several reasons:
- 🔐 Incorrect password: Check the case of characters and special characters.
- 📵 Hidden SSID: Disable the option in your router settings.
Hide SSIDor manually enter the network name inwpa_supplicant.conf. - 🔄 Incompatible security type: Try changing the encryption type in your router.
WPA3onWPA2-PSK. - 📡 Weak signal: Check the signal level with the command
iwconfig. IfSignal levelbelow-70 dBm, move the rig closer to the router.
Also check the logs:
dmesg | grep wlan
Look for errors like authentication with [MAC] timed out.
Is it possible to connect Hive OS to a public Wi-Fi network (for example, in a cafe)?
Technically yes, but it is highly discouraged for several reasons:
- 🔒 Safety: Public networks often intercept traffic, and mining data (including pool passwords) is transmitted in cleartext.
- 🚫 Blocks: The network administrator may block your
MAC addressfor high traffic. - 📉 Instability: Connection breaks will result in share loss and a decrease in hashrate.
If there is no other option, use VPN (For example, WireGuard) to encrypt traffic. Setting up a VPN in Hive OS requires manual editing of configuration files.
How to update Hive OS without wireless internet?
Updates Hive OS You can install it via Wi-Fi, but there are some nuances:
- Make sure the connection is stable (ping to
api.hiveos.farm(not interrupted). - In the web interface, go to
Workers → [your rig] → Updates. - Select the version to update and click
Update. - Wait until it completes (do not turn off the rig!).
If the update is interrupted:
- Check the integrity of the file system with the command
fsck. - Reinstall if necessary Hive OS from a flash drive.