armbian / build

## 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
 [code] 
## 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/Debian 13 (Trixie)
- **Containerized:** Any Docker-capable Linux
- **Windows:** WSL2 with Armbian/Debian 13 (Trixie)
### 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!
## Armbian Partners
Our partnership program supports Armbian's development and community. Learn more about our Partners.