qiurui
/
armbian-build
mirror of https://github.com/armbian/build.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf
17,156 Commits 88 Branches 135 Tags 962 MiB
Shell 72%
Python 9.3%
GSC 8.2%
Batchfile 4%
QML 1.6%
Other 4.9%
Go to file
Igor Velkov 9e251e885f extension: kernel-version-toolchain for compiler in artifact version 
Add opt-in extension that includes gcc/clang major.minor version in the
kernel artifact version string for cache invalidation when the toolchain
changes. Enable with ENABLE_EXTENSIONS="kernel-version-toolchain".

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 		2026-02-10 14:21:28 -05:00
.github build(deps): bump tj-actions/changed-files from 47.0.1 to 47.0.2 2026-02-10 00:06:03 +01:00
.vscode
…
config Revert "Sunxi64 EDGE: Add missing audio related modules and other" 2026-02-09 15:46:33 +01:00
extensions extension: kernel-version-toolchain for compiler in artifact version 2026-02-10 14:21:28 -05:00
lib extension: kernel-version-toolchain for compiler in artifact version 2026-02-10 14:21:28 -05:00
packages feat: add extraargs from armbianEnv for mkbootimg 2026-02-05 01:04:38 +01:00
patch rockchip64: rewrite kernel patches 2026-02-09 23:59:10 +01:00
tools feat: implement parallel repository management workflow 2026-01-11 00:37:46 +01:00
.coderabbit.yaml CodeRabbit review noise reduction 2025-12-15 20:56:55 +01:00
.editorconfig Fix errors in .editorconfig 2026-02-09 00:28:39 +01:00
.gitignore Adjusting ORAS cache location, runners (#5129) 2023-05-02 11:08:34 +02:00
CONTRIBUTING.md Improve labeling system - refactor labeling logic (#5916) 2023-11-19 22:36:06 +01:00
CREDITS.md
…
LICENSE
…
README.md Deprecate Matrix (#9318) 2026-01-31 09:32:23 +01:00
VERSION bump VERSION 2025-12-01 22:01:46 +01:00
action.yml build(deps): bump actions/checkout from 5 to 6 2025-11-24 20:31:42 +01:00
compile.sh artifacts: `download-artifact` CLI. makes sure to only used local .deb, or download from OCI, never build 2023-05-16 20:09:47 +02:00
requirements.txt build(deps): bump setuptools from 80.10.2 to 82.0.0 2026-02-10 00:32:40 +01:00
shell.nix Add compatibility for non-FHS 3.0 systems 2023-07-19 23:16:22 +02:00

README.md

Armbian logo

Purpose of This Repository

The Armbian Linux Build Framework creates customizable OS images based on Debian or Ubuntu for single-board computers (SBCs) and embedded devices.

It builds a complete Linux system including kernel, bootloader, and root filesystem, giving you control over versions, configuration, firmware, device trees, and system optimizations.

The framework supports native, cross, and containerized builds for multiple architectures (x86_64, aarch64, armhf, riscv64) and is suitable for development, testing, production, or automation.

Looking for prebuilt images? Use Armbian Imager — the easiest way to download and flash Armbian to your SD card or USB drive. Available for Linux, macOS, and Windows.

Quick Start

git clone https://github.com/armbian/build
cd build
./compile.sh

Build demonstration

Build Host Requirements

Hardware

  • RAM: ≥8GB (less with KERNEL_BTF=no)
  • Disk: ~50GB free space
  • Architecture: x86_64, aarch64, or riscv64

Operating System

  • Native builds: Armbian or Ubuntu 24.04 (Noble)
  • Containerized: Any Docker-capable Linux
  • Windows: WSL2 with Armbian/Ubuntu 24.04

Software

  • Superuser privileges (sudo or root)
  • Up-to-date system (outdated Docker or other tools can cause failures)

Resources

  • Documentation — Comprehensive guides for building, configuring, and customizing
  • Website — News, features, and board information
  • Blog — Development updates and technical articles
  • Forums — Community support and discussions

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines on reporting issues, submitting changes, and contributing code.

Support

Community Forums

Get help from users and contributors on troubleshooting, configuration, and development. 👉 forum.armbian.com

Real-time Chat

Join discussions with developers and community members on IRC or Discord. 👉 Community Chat

Paid Consultation

For commercial projects, guaranteed response times, or advanced needs, paid support is available from Armbian maintainers. 👉 Contact us

Contributors

Thank you to everyone who has contributed to Armbian!

Contributors

Armbian Partners

Our partnership program supports Armbian's development and community. Learn more about our Partners.