# Orange Pi Zero 2W OS setup

## Recommended image

Use the official Debian 12 Bookworm server image for Orange Pi Zero 2W:

```text
orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.7z
```

Orange Pi's Zero 2W wiki lists Debian 12 Bookworm with Linux 6.1 as supported, and its Linux 6.1 driver table marks Wi-Fi, Type-C USB2.0, TF card boot, and related board features as OK.

Official references:

- https://www.orangepi.org/orangepiwiki/index.php/Orange_Pi_Zero_2W
- https://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-2W.html

## Flashing

1. Download the image into `os/`.
2. Extract the `.7z` file to get the `.img`.
3. Flash the `.img` to the microSD with Balena Etcher, Raspberry Pi Imager, or another verified imaging tool.
4. Mount the flashed boot/root partition and configure first-run Wi-Fi before inserting it into the Orange Pi.

## Headless Wi-Fi first boot

On the flashed SD card, find:

```text
/boot/orangepi_first_run.txt.template
```

Copy it to:

```text
/boot/orangepi_first_run.txt
```

Then set the Wi-Fi fields. `os/orangepi_first_run.example.txt` contains a local example for Korea region code `KR`.

The important values are:

```text
FR_net_change_defaults=1
FR_net_ethernet_enabled=0
FR_net_wifi_enabled=1
FR_net_wifi_ssid='YOUR_WIFI_SSID'
FR_net_wifi_key='YOUR_WIFI_PASSWORD'
FR_net_wifi_countrycode='KR'
```

## First login

For official Debian/Ubuntu Orange Pi images, the usual default accounts are:

```text
orangepi / orangepi
root     / orangepi
```

Change the password on first login.

```bash
passwd
sudo passwd root
```