51 lines
2.7 KiB
Markdown
51 lines
2.7 KiB
Markdown
# Armbian #
|
|
|
|
Debian based Linux for ARM based single-board computers
|
|
|
|
[https://www.armbian.com](https://www.armbian.com "Armbian")
|
|
|
|
|
|
# How to build an image or a kernel?
|
|
|
|
Supported build environment is **Ubuntu Bionic 18.04 x64** ([minimal iso image](http://archive.ubuntu.com/ubuntu/dists/bionic/main/installer-amd64/current/images/netboot/mini.iso)).
|
|
|
|
- guest inside a [VirtualBox](https://www.virtualbox.org/wiki/Downloads) or other virtualization software,
|
|
- guest managed by [Vagrant](https://docs.armbian.com/Developer-Guide_Using-Vagrant/). This uses Virtualbox (as above) but does so in an easily repeatable way,
|
|
- inside a [Docker](https://docs.armbian.com/Developer-Guide_Building-with-Docker/), [systemd-nspawn](https://www.freedesktop.org/software/systemd/man/systemd-nspawn.html) or other container environment [(example)](https://github.com/armbian/build/pull/255#issuecomment-205045273),
|
|
- 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](https://docs.armbian.com/Developer-Guide_Build-Options/) and [additional customization](https://docs.armbian.com/Developer-Guide_User-Configurations/).
|
|
|
|
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](https://github.com/igorpecovnik/lib/blob/master/.github/ISSUE_TEMPLATE.md) notice first before opening an issue.
|
|
|
|
# How to contribute?
|
|
|
|
- [Fork](https://help.github.com/articles/fork-a-repo/) the project
|
|
- Make one or more well commented and clean commits to the repository.
|
|
- Perform a [pull request](https://help.github.com/articles/creating-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](https://guides.github.com/features/issues/) to discuss the new feature.
|
|
|
|
If you are struggling, check [this detailed step by step guide on contributing](https://www.exchangecore.com/blog/contributing-concrete5-github/).
|
|
|
|
## Where to get more info?
|
|
|
|
- [Documentation](https://docs.armbian.com/Developer-Guide_Build-Preparation/ "Developer resources")
|
|
- [Prebuilt images](https://www.armbian.com/download/ "Download section")
|
|
- [Support forums](https://forum.armbian.com/ "Armbian support forum")
|