> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lagerdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WiFi

> Manage WiFi network settings on a Lager Box

View, connect to, and manage WiFi networks on a Lager Box.

## Syntax

```bash theme={null}
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.

```bash theme={null}
lager wifi status [--box BOX]
```

### Options

| Option       | Description                 |
| ------------ | --------------------------- |
| `--box TEXT` | Lagerbox name or IP address |

### Examples

```bash theme={null}
lager wifi status --box my-lager-box
```

***

## `lager wifi access-points`

Scan for and list WiFi access points visible to the box.

```bash theme={null}
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

```bash theme={null}
# 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.

```bash theme={null}
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

```bash theme={null}
# 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.

```bash theme={null}
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

```bash theme={null}
# 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
```

<Warning>
  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.
</Warning>

***

## 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