Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

4.8K stars 2.7K forks 4.8K watchers Shell GNU General Public License v2.0
aarch64 arm debian firmware framework image iso kernel kernel-compilation kernel-hacking lightweight linux linux-distribution operating-system u-boot ubuntu uefi wsl2 x86
13 Open Issues Need Help Last updated: Sep 3, 2025

Open Issues Need Help

View All on GitHub

AI Summary: This GitHub issue is a feature request inquiring about the possibility of porting Armbian to the Ugoos AM9 device, which is equipped with the S905X5 SoC. The user is asking if support for this specific hardware can be added to Armbian.

Complexity: 4/5
Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86
Feature Request Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: A user reports an infinite loop occurring during the unmounting phase of a build process on a Helios64 device. This issue is specific to builds using Ubuntu and Debian Trixie with the latest framework builder, but does not occur with Debian Bookworm. The logs indicate that `/sys` and `/dev` related targets are either busy or not recognized as mount points, leading to the unmount failure.

Complexity: 3/5
Bug Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86
Desktop Ready to merge Bug Dependencies Good first issue reproducible

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The task is to fix a bug in the Armbian build framework's `armbian-firstlogin` script. The script currently uses the wrong environment variable (`PRESET_ROOT_KEY` instead of `PRESET_USER_KEY`) to retrieve the SSH public key for the user during the initial login process. The fix involves correcting the variable name in the specified line of the script.

Complexity: 2/5
Bug Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The task is to debug a build failure in the Armbian build framework. The error occurs when attempting to build an image with an XFS filesystem, resulting in a 'Module xfs not found' error. The solution likely involves ensuring the necessary XFS kernel modules are installed on the host Ubuntu 24.04 system before running the Armbian build script.

Complexity: 4/5
Bug Not framework bug Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The task is to debug a build failure in the Armbian build framework. The error arises from a missing `gcc-loongarch64-linux-gnu` package, which needs a version qualifier (e.g., `gcc-13-loongarch64-linux-gnu`) to correctly install the required compiler for the LoongArch64 architecture. The solution involves identifying the correct GCC version needed by the build script for the specified board (`radxa-cubie-a5e`) and updating the Armbian build framework's Dockerfile or package manager configuration to include the correctly versioned package.

Complexity: 4/5
Bug Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The task is to investigate why an Armbian build with a 5.15 kernel (specifically for uefi_x86 oldlegacy) fails to boot beyond GRUB. This involves analyzing the build process, configuration files (like `config/kernel/linux-uefi-x86-legacy.config` and `config/sources/families/include/uefi_common.inc`), and potentially modifying the build framework to support this older kernel version if necessary. The goal is to either resolve the existing boot issue or determine why the 5.15 kernel is incompatible with the current build system.

Complexity: 4/5
Feature Request Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The task requires building a custom Armbian OS image for the Radxa Zero 2 (Pro) SBC that includes the necessary drivers (mesa-etnaviv with specific configuration options) to enable the device's NPU for TensorFlow Lite inference. This involves using the Armbian build framework, potentially modifying build scripts or configurations to incorporate the driver and ensure its proper compilation and integration into the final image.

Complexity: 4/5
Not framework bug Feature Request Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The task requires adding the configuration option `CONFIG_BACKLIGHT_GPIO=m` to the appropriate kernel configuration files (linux-sunxi-{current,edge,legacy}.config) within the Armbian build framework. This addition enables GPIO backlight support, specifically needed for SPI-interface LCD panels using the Tiny DRM driver. The change should be integrated into the build process to ensure it's included in future Armbian images.

Complexity: 3/5
Feature Request Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: The Armbian build framework is failing to execute `/bin/bash` within a chroot environment during a GitHub Actions workflow for the nanopi neo air board. The error occurs when attempting to add the Armbian repository and authentication key. This requires debugging the build script (`distro-specific.sh`) to identify why the bash shell is unavailable within the chroot environment, likely due to an issue with the chroot setup or the base image used.

Complexity: 4/5
Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86

AI Summary: Debug a build issue in the Armbian Linux build framework where incorrect modules are built for specific boards and kernels, resulting in errors when loading and unloading simple kernel modules. The issue is reproducible across multiple kernel versions but not on others or x86 systems. Debugging will involve analyzing build logs, comparing configurations across different kernel versions, and potentially investigating differences in module compilation between the affected boards and working systems.

Complexity: 4/5
Bug Not framework bug Good first issue

Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf

Shell
#aarch64#arm#debian#firmware#framework#image#iso#kernel#kernel-compilation#kernel-hacking#lightweight#linux#linux-distribution#operating-system#u-boot#ubuntu#uefi#wsl2#x86