HiveOS: How to Set Up WiFi: A Complete Guide

Setting up a wireless connection in the HiveOS operating system is often a critical task for miners whose rigs are located far from the router or lack the ability to use a LAN cable. Unlike traditional desktop operating systems, there is no graphical interface with buttons, so the process requires an understanding of the command line. Proper network configuration ensures stable operation. miner and prevents loss of balls due to connection breaks.

The main difficulty is that HiveOS prioritizes wired connections by default, ignoring WiFi adapters unless configured accordingly. You'll need access to the rig's console via a monitor and keyboard, or remote access via SSH if a wired connection is temporarily available. It's important to understand that not all wireless adapters are supported by the Linux kernel, which the system is based on, so hardware compatibility is the first step to success.

In this guide, we'll cover all the methods for activating the wireless module in detail, from using built-in utilities to manually editing configuration files. We'll also cover common driver errors and how to troubleshoot them. HiveOS Provides flexible network management tools that, when used correctly, allow you to achieve stable ping even in noisy environments.

Checking WiFi adapter compatibility with HiveOS

Before starting any manipulations, you need to ensure that your USB WiFi adapter is physically recognized by the operating system. HiveOS is based on Ubuntu, so hardware support depends on the availability of drivers in the Linux kernel. Most modern adapters based on Realtek, Ralink, and Atheros chips work out of the box, but some exotic models may require manual driver installation, which is not always convenient in a mining environment.

To test, connect the adapter to a USB port and enter the rig's console. Enter the command lsusb, which will list all connected USB devices. If your adapter appears in the list (usually identified by its vendor ID and product ID), then physical contact is established. Next, check whether the network device was created by running the command ip link or ifconfig -a.

⚠️ Note: If the adapter is displayed in lsusb, but doesn't appear as a network interface (e.g., wlan0), this indicates a missing driver. In this case, attempting to configure the network will be futile without first compiling or installing the software.

Particular attention should be paid to the adapter's power. For stable 24/7 operation, it is recommended to use models with an external antenna. Built-in antennas in miniature "whistles" often do not provide sufficient signal strength, resulting in increased noise. rejected balls (rejected shares) and unstable ping to the pool.

Setting up WiFi using nmtui

The easiest and safest way to set up a wireless network in HiveOS is to use the NetworkManager text interface, known as nmtuiThis method eliminates the need to manually enter complex commands and minimizes the risk of syntax errors in configuration files. The utility is available in most HiveOS builds and allows for visual connection management.

To run it, open the terminal and enter the command nmtuiA blue menu with several options will open. Select "Edit a connection" or "Activate a connection" using the arrow keys and Enter. If you're setting up a network for the first time, choose to create a new profile.

In the menu that opens, you must perform the following actions:

• 📡 Select the "WiFi" connection type and click Create.
• 🔍 In the SSID field, enter the name of your wireless network or find it in the list of available ones.
• 🔐 In the WiFi Security section, select a security method (usually WPA & WPA2 Personal) and enter a password.
• ✅ Click OK to save and activate the connection in the main menu.

After a successful connection, the system will automatically assign an IP address via DHCP. You can check the status with the command ip addr, where the address should appear next to the wlan0 interface. If the connection doesn't work the first time, try restarting the network service with the command sudo systemctl restart NetworkManager.

Manual configuration via config.json

For advanced users or in cases where graphical utilities do not work, HiveOS allows you to configure the network directly through the main configuration file. config.jsonThis method is the most reliable, as the parameters are specified at the system level and are applied at every startup. However, any syntax error in the JSON format may prevent the rig from connecting to the Hive server.

The configuration file is located at the path /hive/config/config.jsonTo edit it, use the nano or vim text editor. You'll need to find the section responsible for the network or add a new entry for WiFi. The entry structure must strictly adhere to JSON requirements, including commas and quotation marks.

An example of the correct structure for adding a WiFi network:

{
"wifi": {
"ssid":"Your_network_name",
"password":"Your_password",
"security":"WPA2"
}
}

After making changes, save the file (in nano, press Ctrl+O, then Enter) and exit (Ctrl+X). For the changes to take effect, reboot the rig with the command rebootThis method is especially useful for mass rig setups, where the configuration file can be prepared in advance on a PC and copied to a flash drive.

⚠️ Attention: When editing config.json It's critically important to maintain JSON syntax. An extra comma at the end of the last element or missing quotation marks will cause the file to be ignored by the system.

Using the nmcli command line

Utility nmcli (Network Manager Command Line Interface) is a powerful tool for managing your network without leaving the command line. It allows you to create, modify, and delete connections, as well as monitor their status. For users accustomed to the terminal, this method is often faster than using nmtui.

The first step is to scan for available networks. Run the command nmcli dev wifi listto see a list of WiFi access points. In the output, you'll see the SSID, SIGNAL (signal strength), BARS, and SECURITY columns. Find your network and remember the exact SSID, as it's case-sensitive.

To connect, use the following command:

nmcli dev wifi connect"SSID_network" password"Your_password"

If the network is hidden, add a flag hidden yesAfter the command is successfully executed, the system will attempt to obtain an IP address and establish a connection. The status can be checked with the command nmcli con show --active.

The table below lists the basic commands. nmcli, which may be needed for diagnosis: