Armbian - автоматическая система сборки образов ОС Linux для популярных одноплатных ПК
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
MX_Master 2a26068eb3 * arisc fw update 6 days ago
.github Update PULL_REQUEST_TEMPLATE.md 1 year ago
config switch RK3399 to 5.0.y 11 months ago
lib Merge pull request #1316 from The-going/clean_2 11 months ago
packages [ rk3399 default ] enable workaround for fixed MAC 11 months ago
patch [ sunxi-dev ] update H5 overclock overlay to correspond to kernel 5.0 DT changes 11 months ago
userpatches * arisc fw update 6 days ago
.dockerignore Improve Docker support 2 years ago
.gitignore Replace of RT patch (4.14 -> 4.19) 11 months ago
Dockerfile Missing dependencies 1 year ago
LICENSE Create LICENSE 5 years ago
README.md Update README.md 1 year ago
Vagrantfile Switch Vagrant to Bionic 1 year ago
compile.sh Fix argument parsing 1 year ago
config-docker.conf Merge safe changes from development to master, part 2 1 year ago
config-sunxi.conf Small fixes 1 year ago
config-vagrant.conf More automation for Vagrant environment 2 years ago
main.sh Add migration checks and messages 2 years ago

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?