Armbian

Ubuntu and Debian images for ARM based single-board computers https://www.armbian.com

How to build my own image or kernel?

Supported build environments:

Ubuntu Xenial 16.04 x64 guest inside a VirtualBox or other virtualization software,
Ubuntu Xenial 16.04 x64 guest managed by Vagrant. This uses Virtualbox (as above) but does so in an easily repeatable way. Please check the Armbian with Vagrant README for a quick start HOWTO,
Ubuntu Xenial 16.04 x64 inside a Docker, systemd-nspawn or other container environment (example). Building full OS images inside containers may not work, so this option is mostly for the kernel compilation,
Ubuntu Xenial 16.04 x64 running natively on a dedicated PC or a server (not recommended unless you build kernel only, for full OS images always use virtualization as outlined above),
20GB disk space or more and 2GB RAM or more available for the VM, container or native OS,
superuser rights (configured sudo or root access).

How to build RT Preempt Kernel for the Asus Tinkerboard to install it as deb package

$sudo ./compile.sh CLEAN_LEVEL=make,alldebs USE_CCACHE=no PROGRESS_LOG_TO_FILE=yes CREATE_PATCHES=yes KERNEL_ONLY=yes KERNEL_CONFIGURE=yes BOARD=tinkerboard BRANCH=next RELEASE=xenial
Add additional patches or change the kernel config if needed during the process

How to build a complete RT Preempt enabled Xenial image

$sudo ./compile.sh CLEAN_LEVEL=make,alldebs USE_CCACHE=no PROGRESS_LOG_TO_FILE=yes BUILD_DESKTOP=yes KERNEL_ONLY=no KERNEL_CONFIGURE=no BOARD=tinkerboard BRANCH=next RELEASE=xenial

What works

Preemption
HDMI
Gigabit Ethernet
WiFi
USB
Rebooting

What doesn't work

Bluetooth

What wasn't testet

Sound in any way

What is disabled on purpose in the Device Tree (might be reenabled)

spidev
MIPI

Execution

apt-get -y install git
git clone https://github.com/armbian/build
cd build
./compile.sh

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.

Reporting issues

Please read this notice first before opening an issue.

arne48/armbian_build