THIS IS A PREVIEW RELEASE WITH OFFICIAL RELEASE IN LATE 2023 SEPTEMBER
- Use the image with a suffix that matches your board! eg. +aml-s905x-cc.img.xz
- Decompress/extract the xz compressed image file ending in .img.xz with 7-zip.
- Write to a MicroSD card with a bit-accurate flashing tool or Raspberry Pi Imager for lite/headless!
- Please read the Debian 11 release notes and Debian 12 release notes especially pertaining to the systemd changes.
- Wireless devices are supported as long as they are upstream.
- eMMC 5.x enhances performance greatly because MicroSD cards can be slow. We recommend SanDisk Extreme and Samsung Pro MicroSD cards.
- ALL-H3-CC (Tritium H3/H5) boards must use eMMC 4.x modules!
- Flashing eMMC instructions
These images use the standard upstream bootchain that is familiar for PC Linux users:
- Bootloader with EFI
- GRUB via EFI
The default username and password are root and root. You will be prompted to change the password on first login. To setup an non-root user, run the following with USERNAME as the login name:
sudo adduser USERNAME sudo adduser USERNAME sudo
Debian base images provide a basic CLI interface along with software packages that interface with hardware.
Network is configured via systemd-networkd.
Please note that systemd has moved interface naming to enX instead of ethX in Debian 12. Please use eth for Debian 11 and en for Debian 12.
Create the following file in /etc/systemd/network/10-en-dhcp.network
/etc/systemd/network$ cat 10-en-dhcp.network [Match] Name=en* [Network] DHCP=yes
Create the following file in 10-wlx-dhcp.network
[Match] Name=wlx* [Network] DHCP=yes IgnoreCarrierLoss=3s
This only handles ARP and IP layers. You still need to handle wireless authentication. You can use either
wpasupplicant. IWD supports WPA3 where as wpa_supplicant only supports WPA3 in Debian 12.
IWD - Recommended
# find the interface name, usually wlx followed by the MAC address ip link show # enable IWD sudo systemctl enable iwd sudo systemctl start iwd # reload systemd configuration from before sudo systemctl daemon-reload # scan and connect to network sudo iwctl station INTERFACE_NAME scan # replace INTERFACE_NAME sudo iwctl station INTERFACE_NAME get-networks #optional, shows network and signal quality sudo iwctl station INTERFACE_NAME connect SSID # replace SSID with the network name # you will be prompted for the network password