A customized fork of the armbian build process to include TFC
 
 
 
 
 
 
Go to file
Vyacheslav Bocharov bed71ca1ee
JetHome: u-boot: add bugfix for broken efi code in commit a9bf024b2933bba0e23038892970a18b72dfaeb4
2022-08-24 12:20:47 +03:00
.github Fix wrong label set for initiating CI at PR (#4093) 2022-08-20 08:50:08 +02:00
.vscode chore: edit code format config (#3578) 2022-03-26 12:41:25 +01:00
config fix build 5.18.19 (#4106) 2022-08-22 15:11:52 +02:00
extensions Add Nvidia driver to the x86 desktop images (#3572) 2022-03-29 21:16:45 +02:00
lib Disable boot logo support as its broken (#4105) 2022-08-22 07:04:28 +02:00
packages Extend network interface auto detection to suppress errors (#4096) 2022-08-21 20:36:20 +02:00
patch JetHome: u-boot: add bugfix for broken efi code in commit a9bf024b2933bba0e23038892970a18b72dfaeb4 2022-08-24 12:20:47 +03:00
tools Sunxi 5.18: add megous patches: tag: orange-pi-5.18-20220627-1924 (#3946) 2022-07-01 01:02:59 +02:00
.dockerignore Improve Docker support 2017-08-01 12:30:34 +03:00
.editorconfig Add settings for .yml files into .editorconfig (#3878) 2022-06-10 21:50:47 +02:00
.gitignore Merge desktop branch (#2662) 2021-02-24 18:19:09 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md (#4062) 2022-08-12 14:30:14 +02:00
LICENSE Create LICENSE 2014-10-08 10:14:29 +02:00
README.md Small fixes and cleanup for action scripts (#4085) 2022-08-19 20:49:18 +02:00
VERSION Bump to Yapok (#3835) 2022-05-29 21:26:25 +02:00
compile.sh Suppress error if gitconfig file does not exists (#3998) 2022-07-16 16:59:40 +02:00

README.md

Armbian logo
Armbian Linux Build Framework

GitHub Workflow Status GitHub Workflow Status GitHub Workflow Status

Twitter Follow Discord Liberapay patrons

Table of contents

What this project does?

  • Builds custom kernel, image or a distribution optimized for low resource HW such as single board computers,
  • Include filesystem generation, low-level control software, kernel image and bootloader compilation,
  • Provides a consistent user experience by keeping system standards across different platforms.

Getting started

Basic requirements

  • x64 or aarch64 machine with at least 2GB of memory and ~35GB of disk space for a virtual machine, container or bare metal installation,
  • Ubuntu Jammy 22.04 x64 or aarch64 for native building or any Docker capable x64 / aarch64 Linux for containerised,
  • Superuser rights (configured sudo or root access).

Simply start with the build script

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

Armbian logo

  • Interactive graphical interface.
  • The workspace will be prepared by installing the necessary dependencies and sources.
  • It guides the entire process until a kernel package or ready-to-use image of the SD card is created.

Build parameter examples

Show work in progress areas in interactive mode:

./compile.sh EXPERT="yes"

Run build framework inside Docker container:

./compile.sh docker

Build minimal CLI Armbian Focal image for Orangepi Zero. Use modern kernel and write image to the SD card:

./compile.sh \
BOARD=orangepizero \
BRANCH=current \
RELEASE=focal \
BUILD_MINIMAL=yes \
BUILD_DESKTOP=no \
KERNEL_ONLY=no \
KERNEL_CONFIGURE=no \
CARD_DEVICE="/dev/sda"

More information:

Download prebuilt images

Compare with industry standards

Check similarity, advantages and disadvantages compared with leading industry standard build software.

Function Armbian Yocto Buildroot
Target general purpose embedded embedded / IOT
U-boot and kernel compiled from sources compiled from sources compiled from sources
Board support maintenance   complete outside outside
Root file system Debian or Ubuntu based custom custom
Package manager APT any none
Configurability limited large large
Initramfs support yes yes yes
Getting started quick very slow slow
Cross compilation yes yes yes

Project structure

├── cache                                Work / cache directory
│   ├── rootfs                           Compressed userspace packages cache
│   ├── sources                          Kernel, u-boot and various drivers sources.
│   ├── toolchains                       External cross compilers from Linaro™ or ARM™
├── config                               Packages repository configurations
│   ├── targets.conf                     Board build target configuration
│   ├── boards                           Board configurations
│   ├── bootenv                          Initial boot loaders environments per family
│   ├── bootscripts                      Initial Boot loaders scripts per family
│   ├── cli                              CLI packages configurations per distribution
│   ├── desktop                          Desktop packages configurations per distribution
│   ├── distributions                    Distributions settings
│   ├── kernel                           Kernel build configurations per family
│   ├── sources                          Kernel and u-boot sources locations and scripts
│   ├── templates                        User configuration templates which populate userpatches
│   └── torrents                         External compiler and rootfs cache torrents
├── extensions                           extend build system with specific functionality
├── lib                                  Main build framework libraries
├── output                               Build artifact
│   └── deb                              Deb packages
│   └── images                           Bootable images - RAW or compressed
│   └── debug                            Patch and build logs
│   └── config                           Kernel configuration export location
│   └── patch                            Created patches location
├── packages                             Support scripts, binary blobs, packages
│   ├── blobs                            Wallpapers, various configs, closed source bootloaders
│   ├── bsp-cli                          Automatically added to armbian-bsp-cli package 
│   ├── bsp-desktop                      Automatically added to armbian-bsp-desktopo package
│   ├── bsp                              Scripts and configs overlay for rootfs
│   └── extras-buildpkgs                 Optional compilation and packaging engine
├── patch                                Collection of patches
│   ├── atf                              ARM trusted firmware
│   ├── kernel                           Linux kernel patches
|   |   └── family-branch                Per kernel family and branch
│   ├── misc                             Linux kernel packaging patches
│   └── u-boot                           Universal boot loader patches
|       ├── u-boot-board                 For specific board
|       └── u-boot-family                For entire kernel family
├── tools                                Tools for dealing with kernel patches and configs
└── userpatches                          User: configuration patching area
    ├── lib.config                       User: framework common config/override file
    ├── config-default.conf              User: default user config file
    ├── customize-image.sh               User: script will execute just before closing the image
    ├── atf                              User: ARM trusted firmware
    ├── kernel                           User: Linux kernel per kernel family
    ├── misc                             User: various
    └── u-boot                           User: universal boot loader patches

🙌 Contribution

Please make sure to read the Contributing Guide before you write any code.

Support

Armbian is free software and provides best effort help through community forums. Make sure to use help of general project search engine and documentation before opening new forum topic. In case you require attention, buy appropriate subscription level before asking for dedicated attention to the issue you have https://www.armbian.com/contact.

Contact

Contributors

Thank you to all the people who already contributed Armbian!

Also

Sponsors

Most of the project is sponsored with a work done by volunteer collaborators, while some part of the project costs are being covered by the industry. We would not be able to get this far without their help.

Would you like your name to appear below?

License

This software is published under the GPL-2.0 License license.