armbian/build
Build
This repository is the Armbian build framework — an embedded Linux build system for generating custom operating system images tailored to single-board computers, primarily targeting ARM and RISC-V architectures. The build process is orchestrated by GNU Makefiles and relies on a chroot-based environment to assemble the root filesystem, manage cross-compilation toolchains, and aggregate binary firmware blobs for hardware compatibility. Kernel and bootloader source trees are fetched via git, with structured patches applied in a controlled sequence, while each supported board is described by a dedicated configuration directory specifying device trees, kernel config fragments, and bootloader parameters.
The framework supports multiple build methods — native compilation, cross-compilation, and containerized builds — enabling reproducible OS images from a single host system. Users can select specific kernel versions, device trees, firmware packages, and system optimizations to produce hardware-tuned images that are resource-efficient for low-memory devices. A containerized build pipeline provides isolated, reproducible environments, and the project also includes a dedicated kernel and bootloader builder that compiles and packages these components for each target board.
All board-specific and user-customizable settings are processed through modular shell scripts that source configuration files and define build variables, offering fine-grained control over the final image. The repository includes documentation and example configurations to guide users through the build process from cloning the source to producing a bootable SD card image.
Features
- Image Build Automation - Generates complete bootable OS images with kernel, bootloader, and root filesystem for single-board computers.
- Cross-Platform Build Systems - Supports multiple CPU architectures including ARM and RISC-V through native, cross, and containerized builds.
- Build Configuration Scripts - Uses modular shell scripts that source configuration files to control all board-specific and user-customizable build settings.
- Custom Build Systems - Provides fine-grained control over kernel versions, device trees, firmware, and system optimizations during the build.
- System Image Generators - Assembles complete operating system images for low-resource hardware with version and firmware selection.
- SBC Specialized OS - Creates custom Linux operating system images tailored for ARM and RISC-V single-board computers.
- Chroot Execution - Constructs root filesystems inside a chroot environment for reproducible OS image creation.
- Kernel and Bootloader Build Pipelines - Builds and packages Linux kernels and bootloaders tailored to ARM and RISC-V single-board computers.
- ARM Firmware and Kernel Image Sets - Selects and assembles specific kernel versions, device trees, and firmware for hardware-tuned images.
- Cross-Compilation Toolchains - Downloads, caches, and invokes cross-compiler toolchains for each target architecture.
- Embedded Linux Cross-Compilation - Builds full OS images for multiple CPU architectures using cross-compilation and other methods.
- Embedded Linux Distribution Building - Creates custom embedded Linux distributions with kernel, bootloader, and filesystem for ARM/ARM64 boards.
- Cross-Compilation Tools - Provides a framework supporting native, cross, and containerized builds for multiple architectures.
- Firmware Image Build Orchestrators - Uses GNU Makefiles to orchestrate the entire firmware image build pipeline.
- Board Support Packages - Provides per-board configuration directories specifying device trees, kernel fragments, and bootloader parameters.
- Kernel Patch Pipelines - Applies structured patch sets to U-Boot and kernel source trees during the build process.
- Containerized Build Environments - Provides a containerized build pipeline for reproducible and isolated OS image creation.
- Lightweight OS Image Builders - Produces resource-efficient Linux images optimized for low-memory single-board computers.
- Vendor Blob Integrations - Aggregates binary firmware blobs from hardware vendors into the final OS image.
- Source-Level Patch Integration - Fetches source trees via git and applies structured patches in a controlled sequence before compilation.
- Development Libraries - Tool for creating customized kernel and Debian images.
