View, connect to, and manage WiFi networks on a Lager Box.
Syntax
lager wifi COMMAND [OPTIONS]
Commands
| Command | Description |
|---|
status | Get the current WiFi status of the box |
access-points | List WiFi access points visible to the box |
connect | Connect the box to a WiFi network |
delete-connection | Delete a saved network from the box |
lager wifi status
Get the current WiFi connection status of the box.
lager wifi status [--box BOX]
Options
| Option | Description |
|---|
--box TEXT | Lagerbox name or IP address |
Examples
lager wifi status --box my-lager-box
lager wifi access-points
Scan for and list WiFi access points visible to the box.
lager wifi access-points [--box BOX] [--interface IFACE]
Options
| Option | Default | Description |
|---|
--box TEXT | | Lagerbox name or IP address |
--interface TEXT | wlan0 | Wireless interface to use for scanning |
Examples
# Scan using default interface
lager wifi access-points --box my-lager-box
# Scan using a specific interface
lager wifi access-points --box my-lager-box --interface wlan1
lager wifi connect
Connect the box to a WiFi network.
lager wifi connect [--box BOX] --ssid SSID [--password PASS] [--interface IFACE]
Options
| Option | Default | Description |
|---|
--box TEXT | | Lagerbox name or IP address |
--ssid TEXT | (required) | SSID of the network to connect to |
--password TEXT | (empty) | Password for the network (omit for open networks) |
--interface TEXT | wlan0 | Wireless interface to use |
Validation
- SSID must be 1-32 printable characters (IEEE 802.11 limit)
- WPA/WPA2 passwords must be 8-63 characters
Examples
# Connect to a WPA2 network
lager wifi connect --box my-lager-box --ssid MyNetwork --password mypassword
# Connect to an open network
lager wifi connect --box my-lager-box --ssid OpenNetwork
# Connect using a specific interface
lager wifi connect --box my-lager-box --ssid MyNetwork --password mypassword --interface wlan1
lager wifi delete-connection
Delete a saved WiFi network from the box. This removes the network configuration so the box will no longer auto-connect to it.
lager wifi delete-connection SSID [--box BOX] [--yes]
Arguments
| Argument | Description |
|---|
SSID | Name of the network to delete |
Options
| Option | Description |
|---|
--box TEXT | Lagerbox name or IP address |
--yes | Skip the confirmation prompt |
Examples
# Delete with confirmation prompt
lager wifi delete-connection MyNetwork --box my-lager-box
# Delete without prompting
lager wifi delete-connection MyNetwork --box my-lager-box --yes
Deleting a WiFi connection may disconnect the box from the network. An ethernet connection will be required to bring the box back online if it was connected via WiFi only.
Notes
- WiFi commands execute on the Lager Box itself, not on your local machine
- The box must be reachable (via ethernet or an existing WiFi connection) to run these commands
- Common wireless interface names:
wlan0, wlan1, wlp2s0, wlp3s0
- Use
lager hello --box <box> to verify connectivity before managing WiFi settings
