Building the Armbian base image

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

Prepare build environment

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 make with sh .\

  • Clone the BitBox Base repository to a local directory.
    git clone
    cd bitbox-base/armbian

Configure build options

The build itself and the initial configuration of the Base image (e.g. hostname, Bitcoin network) can be configured within the configuration file armbian/base/build.conf.

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 build.conf.

Include SSH keys

It is recommended to use SSH keys to access the Base image. You can include your own keys in the file authorized_keys. Please refer to this article on how to create your own set of new keys.

Compile Armbian from source

Now the operating system image can be built. The whole BitBox Base configuration is contained in 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-armbian and 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!
    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
  • After initial build, you can update the image with an adjusted system configuration script, without building Armbian from scratch:
    make update
  • To clean up and remove the build environment, run make clean.