THIS IS A PREVIEW RELEASE WITH OFFICIAL RELEASE IN LATE 2023 SEPTEMBER
The images are located on our distro server. If you encounter any problems, please review the general troubleshoot guide and reply to the post with your issue related to this image.
- 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
- Linux
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
Base Images
Debian base images provide a basic CLI interface along with software packages that interface with hardware.
Network Configuration
Network is configured via systemd-networkd.
Wired Network
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
Wireless Network
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 iwd or 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
wpa_supplicant
#TBC