The goal of building the Armbian operating system from source is to create a highly configurable base image, with granular control over kernel features, that can be written on an eMMC or SD card and boots directly into an operational state.
The process to build the Armbian image for the RockPro64 board is mostly automated and follows Armbian best practices.
It makes use of the Docker containers to perform the build process:
The following build instructions have been tested both on Debian-based Linux systems and within Windows PowerShell.
- Regular computer with x86/x64 architecture, 4GB+ memory, 4+ cores
- minimum of 25 GB free space on a fast drive, preferrably SSD
- any operating system that can run Docker containers is supported
To set up and run the build environment in the virtual machine, the following software needs to be installed:
All sources and build scripts are contained in this repository, which needs to be cloned locally. The following commands are executed in the command line, either the Linux terminal or Windows PowerShell.
In Linux you can directly run
make, while in Windows PowerShell you need to run the build script directly with
sh. In the following instructions, Windows users just replace
- Clone the BitBox Base repository to a local directory.
git clone https://github.com/digitalbitbox/bitbox-base.git cd bitbox-base/armbian
The build itself and the initial configuration of the Base image (e.g. hostname, Bitcoin network) can be configured within the configuration file
To preserve a local configuration, you can copy the file to
build-local.conf. This file is excluded from Git source control and overwrites options from
Now the operating system image can be built. The whole BitBox Base configuration is contained in
customize-armbian-rockpro64.sh and executed in a
chroot environment at the end of the build process.
Note: you might need use
sudo for all
make commands, depending on your Docker configuration.
- Start the initial build process.
- The resulting image is available in
bin/img-armbianand can be written to eMMC or SD card using a program like Etcher. On the Linux command line you can use
dd: once the target medium is connected to your computer, get the device name (e.g.
/dev/sdb). Check it carefully, all data on this device will be lost!
lsblk sudo dd if=bin/img-armbian/Armbian_5.77_Rockpro64_Debian_stretch_default_4.4.176.img of=/dev/sdb bs=64K conv=sync status=progress sync
- After initial build, you can update the image with an adjusted system configuration script, without building Armbian from scratch:
- To clean up and remove the build environment, run