Armbian: WiFi setup via console and GUI

Managing Linux-based single-board computers often requires remote access, and the lack of a wired Ethernet connection makes pre-installation difficult. WiFi setup A critical task. Unlike desktop distributions, Armbian may not have a graphical interface by default, forcing the administrator to rely on the command line and text-based configuration files. Proper initialization of the wireless module ensures server stability, the ability to install updates, and remote system management via SSH.

The connection process varies depending on the kernel version and the network manager used, but the basic principles remain the same. You'll need to know your network name (SSID) and password, as well as physical access to the board or a connected UART adapter for debugging in case of errors. Modern versions of Armbian often use NetworkManager or Connman, but classic wpa_supplicant remains a universal tool that works even on minimalist builds without unnecessary dependencies.

Before entering commands, make sure your wireless adapter is compatible with the Linux kernel used in your setup. Some exotic boards may require manual firmware installation or switching the chip's operating modes via device treeIf you've just written an image to a memory card, the first step should always be checking the available interfaces and driver status to rule out hardware conflicts.

Preparing the system and checking drivers

The first step after loading Armbian is to identify the wireless interface, as its name may differ from the standard one. wlan0. Enter the command ip link or iwconfig in the terminal to see a list of all network devices. If you don't see the WLAN interface, the driver may not have loaded automatically, which often happens with Realtek or Broadcom chips on specific motherboards.

To check loaded kernel modules, use the command lsmod, filtering the output by the name of your chip (for example, rtl, brcm). If the module is missing, you need to add it to the boot configuration or install the package with proprietary drivers via apt, if there's a temporary wired connection. A missing driver is the most common reason why the system doesn't detect WiFi, even if the antenna is physically connected.

⚠️ Note: Some single-board computers (e.g. Orange Pi or NanoPi) require an antenna connection to Power on. Hot-plugging the antenna connector can cause the RF module on the board to burn out.

Make sure that the interface is not in the "DOWN" state. If the interface status shows NO-CARRIER or it is simply turned off, activate it with the command sudo ip link set dev wlan0 upAfter this, repeat the network scan to ensure the device is ready for use. Driver stability directly impacts data transfer speeds and the ability to operate in access point mode.

Setting up WiFi via wpa_supplicant

The classic configuration method, which works on most Linux distributions, involves directly editing the configuration. wpa_supplicantThis method is reliable, does not depend on graphical environments, and is ideal for server tasks where minimal memory consumption is important. The configuration file is usually located at /etc/wpa_supplicant/wpa_supplicant.conf, however, in some versions of Armbian the path may differ.

To create a secure connection, you need to generate a password hash so you don't have to store it in plain text in a text file. Use the utility wpa_passphrase, passing it the network SSID and password, and then copy the resulting block of code into the configuration file. This provides a basic level of security, preventing unauthorized users with access to the file system from reading the password.

sudo wpa_passphrase "MyWiFiNetwork" "SuperSecretPassword"

After adding the configuration, you need to restart the service. wpa_supplicant or reboot the network interface to apply the changes. In modern systems with systemd, this is done via systemctl restart wpa_supplicant@wlan0, although the syntax may vary. If the connection fails, check the logs via journalctl -u wpa_supplicant to find authentication errors.

• 📡 Open the configuration file with root privileges: sudo nano /etc/wpa_supplicant/wpa_supplicant.conf.
• 🔐 Add a network block with the SSID and PSK (password) generated by the utility.
• 🔄 Restart the networking or wpa_supplicant service to apply the settings.
• 🔍 Check the connection status with the command iwgetid or ip addr.

nmcli device wifi connect "MySSID" password "MyPassword" ifname wlan0