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
Igor Pečovnik fc07886a1d
Bsp services RFC (#1015)
* Basic armbian services RFC
- tested building and upgrade
- armbian-optimize-hardware and armbian-setup-hardware have still the same content

* fix permissions

* Forther renaming and small fixes

* Odroid C2 NEXT tiny config adjustement to remove errros from bootup and moving u-boot to 2018.05

* More cleanings

* permissions fix

* More cleanup ...

* permi

* Remove few Ubuntu related things, fix permissions

* Further mini improvements

* Fix logrotate compression and permission issues

* Bugfix

* Wrong services setup at package install. fixing

* RAM logging: workaround for older kernel/btrfs driver versions

* Renaming services, proper config for zram, few bugfixes.

* Various fixes

* Various fixes

* No $TMPFILE needed here

* Various fixes

* Lower this so boards with low memory can use it too

* Various fixes

* Adjust logfile to armbian-hardware-monitor.log

* Remove swap file creation

* Fix permissions in all logrotate configs if needed.

* Prevent loading parallel printer port drivers which we don't need here.
2018-06-16 19:41:16 +02:00
.github Note for the default branch for PRs 2018-04-09 12:03:16 +03:00
config Bsp services RFC (#1015) 2018-06-16 19:41:16 +02:00
lib Bsp services RFC (#1015) 2018-06-16 19:41:16 +02:00
packages Bsp services RFC (#1015) 2018-06-16 19:41:16 +02:00
patch Rock64 RK3328 default patches adjustements 2018-06-16 10:02:43 +02:00
.dockerignore Improve Docker support 2017-08-01 12:30:34 +03:00
.gitignore Improve Vagrant support 2017-08-01 12:31:05 +03:00
compile.sh Add a missing bit to d1a9c8a 2018-05-24 22:33:16 +03:00
config-docker.conf Merge safe changes from development to master, part 2 2018-04-29 16:02:11 +03:00
config-vagrant.conf More automation for Vagrant environment 2017-09-05 17:04:21 +03:00
Dockerfile Sync and update host dependencies 2018-04-29 15:30:20 +03:00
LICENSE Create LICENSE 2014-10-08 10:14:29 +02:00
main.sh Add migration checks and messages 2017-08-01 12:28:19 +03:00
README.md Typo 2018-05-24 15:28:05 +02:00
Vagrantfile Set box version constraint to make sure using latest one and change username to default "vagrant" user (#880) 2018-02-02 13:39:35 +03:00

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. Please check the Armbian with Vagrant README for a quick start HOWTO,
  • inside a Docker, systemd-nspawn or other container environment (example),
  • running natively on a dedicated PC or a server (not recommended),
  • 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).

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?