mirrors/armbian_build
1
0
Fork 0
mirror of https://github.com/armbian/build.git synced 2025-08-06 03:06:59 +02:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
Armbian Linux build framework generates custom Debian or Ubuntu image for x86, aarch64, riscv64 & armhf
15,916 Commits 74 Branches 102 Tags 912 MiB
Shell 69%
Python 9.6%
GSC 7.5%
JavaScript 5%
Batchfile 3.5%
Other 5.4%
main
Go to file
igorpecovnik 19ed979e87
Some checks are pending
Forked Helper / 📢 Run repository dispatch on fork (push) Waiting to run
Details
Announce PR merge to Discord / announcepush (push) Waiting to run
Details
Scorecards Security Scan / Scorecards analysis (push) Waiting to run
Details
Automatic board configs status synchronise
2025-08-05 19:50:41 +02:00
.github Automatic board configs status synchronise 2025-08-05 19:50:41 +02:00
.vscode chore: edit code format config (#3578) 2022-03-26 12:41:25 +01:00
config KickPi K2B: Community Maintained 2025-08-05 07:39:19 -04:00
extensions AIC8800 Extension: Increase support to Linux 6.16.y 2025-08-05 07:39:19 -04:00
lib fix build dep gcc-loongarch64-linux-gnu introduced by new arch loong64 2025-08-05 11:33:56 +08:00
packages aic-bluetooth: Targeted process management and error handling 2025-08-05 07:39:19 -04:00
patch KickPi K2B: Add KASLR Support 2025-08-05 07:39:19 -04:00
tools repo: add loong64 support 2025-08-05 15:12:06 +02:00
.editorconfig shellfmt/.editorconfig: enable trim whitespaces, run shellfmt, no actual code changes (#4849) 2023-02-23 09:24:41 +01:00
.gitignore Adjusting ORAS cache location, runners (#5129) 2023-05-02 11:08:34 +02:00
action.yml Fix and improve Armbian GH Action 2025-05-16 18:58:56 +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 Clean build repository readme file, update logo, declutter (#8391) 2025-07-18 17:43:17 +02:00
requirements.txt build(deps): bump oras from 0.2.33 to 0.2.37 2025-07-29 12:34:49 +02:00
shell.nix Add compatibility for non-FHS 3.0 systems 2023-07-19 23:16:22 +02:00
VERSION Bump build framework version and adjust requirements 2025-05-14 11:59:12 +02:00

README.md

Armbian logo

Purpose of This Repository

The Armbian Linux Build Framework creates minimal, efficient, and fully customizable operating system images based on Debian or Ubuntu. It is designed specifically for low-resource single board computers (SBCs) and other embedded devices.

This toolchain compiles a custom Linux kernel, bootloader, and root filesystem, providing fine-grained control over:

  • Kernel versions and configuration
  • Bootloader selection and customization
  • Filesystem layout and compression
  • Additional firmware, overlays, and device trees
  • System optimizations for performance and size

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

It ensures consistency across devices while remaining modular and extensible through a variety of configuration files, templates, and user patches.

Quick Start

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

Resources

Documentation • Website • Blog • Community Forums

Armbian logo

Build Host Requirements

  • Supported Architectures: x86_64, aarch64, riscv64
  • System: VM, container, or bare-metal with:
    • ≥ 8GB RAM (less with KERNEL_BTF=no)
    • ~50GB disk space
  • Operating System:
    • Armbian / Ubuntu 24.04 (Noble) for native builds
    • Any Docker-capable Linux for containerized setup
  • Windows: Windows 10/11 with WSL2 running Armbian / Ubuntu 24.04
  • Access: Superuser rights (sudo or root)
  • Important: Keep your system up-to-date — outdated tools (e.g., Docker) can cause issues.

Download

Prebuilt Armbian OS Images: https://www.armbian.com/download

Contribute

Learn how to report issues, suggest improvements, or submit code: CONTRIBUTING.md

Support

Armbian offers multiple support channels, depending on your needs:

  • Community Forums
    Get help from fellow users and contributors on a wide range of topics — from troubleshooting to development.
    👉 forum.armbian.com

  • Discord / IRC/ Matrix Chat
    Join real-time discussions with developers and community members for faster feedback and collaboration.
    👉 Community Chat

  • Paid Consultation
    For advanced needs, commercial projects, or guaranteed response times, paid support is available directly from Armbian maintainers.
    👉 Contact us to discuss consulting options.

Contributors

Thank you to all the people who already contributed to Armbian!

Armbian Partners

Armbian's partnership program helps to support Armbian and the Armbian community! Please take a moment to familiarize yourself with our Partners.