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.
Go to file
2015-12-26 10:19:22 +01:00
bin Set Armbian logo to Udoo uboot 2015-12-21 12:13:28 +01:00
config CONFIG_F2FS_FS=y 2015-12-25 18:16:06 +01:00
documentation Changed Win8 / 10 image writer recommendation 2015-12-26 10:19:22 +01:00
patch Cubox and hummingboard 1 / 2 patch fixes, adjustment, tested kernel 4.3.3 2015-12-25 14:32:23 +01:00
scripts firstrun and resize fs rework 2015-12-25 19:30:56 +01:00
boards.sh Rename odroid to odroidxu 2015-12-25 10:03:03 +01:00
build-all.sh Removed references to outdated SOURCE_COMPILE variable 2015-12-19 17:35:43 +03:00
common.sh Moved writing u-boot to separate function write_uboot 2015-12-25 20:04:33 +03:00
compile.sh New way of customizing images 2015-12-22 20:41:43 +03:00
configuration.sh Bugfix at configuration 2015-12-25 17:18:36 +01:00
debootstrap.sh Fixed variable name 2015-12-23 21:28:14 +03:00
desktop.sh Moved installing of desktop packages to custom_debootstrap 2015-12-23 20:48:41 +03:00
distributions.sh Moved installation of distribution-specific packages to debootstrap 2015-12-19 16:44:01 +03:00
general.sh Small changes 2015-12-25 12:25:17 +03:00
LICENSE Create LICENSE 2014-10-08 10:14:29 +02:00
main.sh Small changes 2015-12-25 12:25:17 +03:00
makeboarddeb.sh Show message at first login fixed 2015-12-21 13:43:01 +01:00
patching.sh Removed unneeded description 2015-12-18 16:37:39 +03:00
README.md Build script complete rewrite. Added user patches and WIP boards: Orangepi+, Lemaker Guitar 2015-12-02 20:33:32 +01:00
repo-show.sh Build script complete rewrite. Added user patches and WIP boards: Orangepi+, Lemaker Guitar 2015-12-02 20:33:32 +01:00
repo-update.sh Build script complete rewrite. Added user patches and WIP boards: Orangepi+, Lemaker Guitar 2015-12-02 20:33:32 +01:00
upgrade.sh Build script complete rewrite. Added user patches and WIP boards: Orangepi+, Lemaker Guitar 2015-12-02 20:33:32 +01:00

How to build my own image?

Preparation

  • x86 machine running any OS, 4G ram, SSD, quad core (recommended),
  • virtual box or similar virtualization software, (highly recommended)
  • host system is highly recommended to be Ubuntu 14.04 (some but not all sources can also compile on Ubuntu 15.04, Mint 17.2 and Debian Jessie),
  • installed basic system, OpenSSH and Samba (optional),
  • root access.

Execution

apt-get -y install git
git clone https://github.com/igorpecovnik/lib --depth 1
cp lib/compile.sh .
chmod +x compile.sh
./compile.sh

This will download all necessary sources, execute compilation and build an bootable image. Most of things will be cached so next run will be extremly faster!

How to build my own kernel?

Prerequisition are the same as building an image!

Edit compile.sh prior to running and alter switch:

KERNEL_ONLY="yes"

In directory (output/debs) you will find deb packed kernel, together with headers, firmware and u-boot.

If you are doing changes to kernel source, disable GIT lock with:

FORCE_CHECKOUT="no"

If you want to invoke menu configuration:

KERNEL_CONFIGURE="yes"

More info: