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.
aarch64armdebianfirmwareframeworkimageisokernelkernel-compilationkernel-hackinglightweightlinuxlinux-distributionoperating-systemu-bootubuntuuefiwsl2x86
f416c35c16
* Minimal build setup (#1463) * Netplan folder check & armbian-tools dependency on expect (and tcl) solved (#1464) * Prevent netplan configration if it is not installed * Resolved expect dependecy of armbian-tools * More packages added for armbian-tools * Added python3-apt and rsyslog to minimal installation * Debootstrap variant doesn't play nice. We loose networking and it affects standard builds as well. Removing. * Python-to-Bash conversion (#1470) * Remove python3-apt dependency from BSP package, fix netplan error also on Disco and putting back varint=minbase ... tested Disco, Bionic * Distinguish package list: *-minimal.list and *-desktop.list * Enable Wireguard back which was removed by mistake. https://github.com/armbian/build/issues/1471 * Having minbase debootstrap variant for all will require further adjustements with current package base - backward compatibility. Minimal image is now Python free but need further testings ... * Add wireless-regdb and crda to the pakage base, fix Ubuntu keyring warning while debootstrap. * Add figlet to sort out missing fonts * Moving few packages here and there. Bugfix when creating a cache package list * Manually compared base images - they are the same with small insignificant difference. Minimal image has to be futher tuned * Adjustements for bash powered lsb_release, adding some needed packages * Fixed (no) network problems on Bionic/Disco * Add rsync to debootstrap_list and few minor fixes * Adjust text in lsb_release * Olimex Micro A20: fix wrong boot config * Remove duplicate depenedency * Odroid C1: adjust kernel config |
||
|---|---|---|
| .github | ||
| config | ||
| lib | ||
| packages | ||
| patch | ||
| .dockerignore | ||
| .gitignore | ||
| compile.sh | ||
| config-docker.conf | ||
| config-vagrant.conf | ||
| Dockerfile | ||
| LICENSE | ||
| main.sh | ||
| README.md | ||
| Vagrantfile | ||
| VERSION | ||
Armbian
Debian based Linux for ARM based single-board computers
How to build an image or a kernel?
Supported build environment is Ubuntu Bionic 18.04 x64 (minimal iso image).
- guest inside a VirtualBox or other virtualization software,
- guest managed by Vagrant. This uses Virtualbox (as above) but does so in an easily repeatable way,
- inside a Docker, systemd-nspawn or other container environment (example),
- running natively on a dedicated PC or a server (not recommended),
- 25GB disk space or more and 2GB RAM or more available for the VM, container or native OS,
- superuser rights (configured
sudoor root access).
Execution
apt-get -y install git
git clone https://github.com/armbian/build
cd build
./compile.sh
Make sure that full path to the build script does not contain spaces.
You will be prompted with a selection menu for a build option, a board name, a kernel branch and an OS release. Please check the documentation for advanced options and additional customization.
Build process uses caching for the compilation and the debootstrap process, so consecutive runs with similar settings will be much faster.
How to report issues?
Please read this notice first before opening an issue.
How to contribute?
- Fork the project
- Make one or more well commented and clean commits to the repository.
- Perform a pull request in github's web interface.
If it is a new feature request, don't start the coding first. Remember to open an issue to discuss the new feature.
If you are struggling, check this detailed step by step guide on contributing.