2
5
Fork
You've already forked build
1
Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf https://www.armbian.com
  • Shell 69.9%
  • GSC 9.3%
  • Python 9.1%
  • Batchfile 4.6%
  • C 3.3%
  • Other 3.7%
2026年07月14日 05:49:03 +02:00
.github build(deps): bump actions/labeler from 6.1.0 to 6.2.0 2026年07月10日 08:13:07 +02:00
.vscode chore: edit code format config ( #3578 ) 2022年03月26日 12:41:25 +01:00
config update two stale references 2026年07月14日 05:49:03 +02:00
extensions extensions/radxa-aic8800: allow dkms on the 7.1 edge kernel 2026年07月11日 13:58:13 +02:00
lib cli: add show-extensions command to list extension hook points 2026年07月09日 19:14:46 +03:00
packages sun60iw2: bring up AIC8800 UART Bluetooth on the Orange Pi A733 boards ( #10149 ) 2026年07月11日 13:57:46 +02:00
patch cleanup patchsets no longer used 2026年07月14日 05:49:03 +02:00
tools validate-board-config: follow source ${SRC}/config/boards/<foo> inheritance 2026年05月02日 20:56:34 +02: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
.gitattributes Derive PB2 USB gadget MACs from identity 2026年06月21日 14:19:43 +02:00
.gitignore fix(gitignore): ignore __pycache__ at all depths ( #7863 ) 2026年03月05日 09:53:15 +01:00
.pre-commit-config.yaml [StepSecurity] Apply security best practices 2026年05月17日 09:00:02 +02:00
action.yml build(deps): bump actions/checkout from 6.0.3 to 7.0.0 2026年06月19日 19:38:17 +02: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
CONTRIBUTING.md Improve labeling system - refactor labeling logic ( #5916 ) 2023年11月19日 22:36:06 +01:00
CREDITS.md Add / modify (c) in bash scripts ( #4922 ) 2023年03月09日 18:30:40 +01:00
LICENSE Create LICENSE 2014年10月08日 10:14:29 +02:00
README.md Deprecate Matrix ( #9318 ) 2026年01月31日 09:32:23 +01:00
renovate.json5 ci: track pinned CLI tool versions with Renovate 2026年05月30日 02:32:14 +03:00
requirements.txt build(deps): bump gitpython from 3.1.50 to 3.1.51 2026年07月13日 14:59:24 +02:00
shell.nix Add compatibility for non-FHS 3.0 systems 2023年07月19日 23:16:22 +02:00
VERSION Update VERSION 2026年06月05日 10:23:42 +02:00

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.