enoch/armbian-build
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
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.
6,730 Commits 95 Branches 139 Tags 940 MiB
Shell 71.5%
Python 9.1%
GSC 8.5%
Batchfile 3.9%
QML 1.6%
Other 5.4%
01fec6b3b4
Go to file
Levin Du 01fec6b3b4 lib/main.sh: allow correctly use of 'head' in BRANCH reference. (#1611) 
In fetch_from_repo() from general.sh, when ref uses `head` as value, the ref_name
will be set to `HEAD`, which is later used as a subdir:

   local workdir=$dir/$ref_name

This commit makes the directories consistent with the workdir above.
2019-11-16 09:49:00 +01:00
.github Create FUNDING.yml 2019-06-16 18:53:35 +02:00
config Rockchip PCIe driver change to Builtin (#1623) 2019-11-16 09:19:35 +01:00
lib lib/main.sh: allow correctly use of 'head' in BRANCH reference. (#1611) 2019-11-16 09:49:00 +01:00
packages Update armbian-ramlog (#1620) 2019-11-11 23:17:14 +01:00
patch Rock Pi 4A fixed build with correct add-trust-ini.patch 2019-11-06 18:33:43 +00:00
.dockerignore Improve Docker support 2017-08-01 12:30:34 +03:00
.editorconfig Added .editorconfig, removed obsoleted upgrade.sh and main.sh, launching user_config function. (#1543) 2019-09-07 23:28:42 +02:00
.gitignore Add /userpatches to .gitignore (#1585) 2019-10-06 20:56:28 +02:00
compile.sh fix shell script execute after su (#1581) 2019-10-01 16:53:22 +02:00
LICENSE Create LICENSE 2014-10-08 10:14:29 +02:00
README.md Update README.md 2019-01-15 12:22:56 +01:00
VERSION Bump version to 5.99 (#1606) 2019-10-29 21:11:07 +01:00

README.md

Armbian

Debian based Linux for ARM based single-board computers

https://www.armbian.com

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 sudo or 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.

Where to get more info?