mic/docs/01-orange-pi-os.md

Orange Pi Zero 2W OS setup

Recommended image

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

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:

/boot/orangepi_first_run.txt.template

Copy it to:

/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:

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:

orangepi / orangepi
root     / orangepi

Change the password on first login.

passwd
sudo passwd root