# armbian/build

The official build framework for the Armbian Linux distribution. This repository contains the complete toolchain and scripts required to compile custom OS images from source, including kernel configuration, U-Boot handling, and board-specific tweaks for various ARM and ARM64 single-board computers.

Repository: https://github.com/armbian/build
Canonical: https://ross.abutalabs.com/products/build
Homepage: https://www.armbian.com
Language: Shell
License: GPL-2.0
License Family: copyleft
Topics: kernel-compilation, arm, ubuntu, debian, kernel, lightweight, operating-system, linux, framework, x86, uefi, kernel-hacking, linux-distribution, firmware, image, iso, wsl2, u-boot, aarch64
Last push: 2026-08-26T22:54:16+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 4348, "days_push": 7, "days_rel": 9, "gap_med": 7.0, "n_releases_24m": 105}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5378, forks 3109 (observed 2026-08-28T04:09:16.229257+00:00)

## What it is
The official build framework for the Armbian Linux distribution, a shell-based toolchain that compiles customizable Debian- or Ubuntu-based OS images from source for single-board computers. It automates the entire stack — kernel compilation with board-specific patches, U-Boot bootloader handling, firmware, device trees, and root filesystem assembly — for hundreds of ARM, ARM64, RISC-V, and x86 boards.

## Use cases
- build a custom linux os image for my arm single-board computer
- compile a patched kernel for a specific sbc board
- create debian or ubuntu based bootable sd card images from source
- cross-compile kernel and bootloader for embedded arm devices
- make reproducible automated builds of linux distributions for iot hardware
- customize device trees and firmware for rockchip or allwinner boards
- build armbian images in a container or on wsl2

## When to choose
- You need a fully custom Debian/Ubuntu-based image for a supported SBC with board-specific kernel patches, device trees, and drivers
- You want reproducible, one-command builds of kernel, bootloader, and root filesystem across x86_64, aarch64, armhf, and riscv64 targets
- You are developing or testing kernel changes, board tweaks, or firmware for ARM/embedded hardware
- You need automated image builds for production, CI, or hardware fleets from a single unified interface

## When to avoid
- You just want to install Armbian on a board — download a prebuilt image with Armbian Imager instead
- You don't have a capable Linux build host (native builds need Debian/Armbian, ~8GB RAM, ~50GB disk; Windows only via WSL2) and don't want to use Docker
- You need a general-purpose build system for compiling a single application rather than entire OS images
- You target hardware not among the 300+ supported boards and can't contribute board support yourself

## Facets
- artifact type: framework
- maturity: active
- function: build-tool, embedded, developer-tools
- domain: embedded-systems, operating-systems, developer-tools, hardware
- platform: cli, embedded
- tags: armbian, linux-distribution, os-image-builder, single-board-computers, kernel-compilation, u-boot, bootloader, debian, ubuntu, arm64, riscv64, device-tree, firmware, reproducible-builds, linux, docker

## Member repositories
- armbian/build (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:16.229257+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:58:26.924199+00:00, confidence not recorded.
  - readme: https://github.com/armbian/build (fetched 2026-08-28T04:09:16.229257+00:00, sha 9dff5461f11d)
  - homepage: https://www.armbian.com (fetched 2026-08-29T08:52:54.595912+00:00, sha 96df51cff01e)
  - site_page: https://docs.armbian.com (fetched 2026-08-29T08:52:54.605296+00:00, sha a93a8761deda)
- Data as of 2026-08-30T08:39:29.467469+00:00.