Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tag: 0.1
Fetching contributors…

Cannot retrieve contributors at this time

64 lines (39 sloc) 2.198 kb

Erlang-powered Buildroot repo for the BeagleBone

This README contains basic instructions for creating a system image for the BeagleBone using Buildroot. The image is meant for creating embedded Erlang nodes. Packages can easily be added using Buildroot's make menuconfig configuration editor.

Preparing your system

Buildroot requires several packages to be installed on the system before it can work. On Ubuntu, the following apt-get line is sufficient:

sudo apt-get install git-core bison flex g++ gettext texinfo libncurses5-dev


To build a disk image, run:


This will result in a .img file being built. This takes a while.

If you are hacking the main image, you probably want more granularity in building everything. First tell Buildroot which configuration to use:

make beaglebone_erlang_defconfig

To build everything, run:


The build output is stored in the output/images directory. Subsequent builds are faster. It is possible to perform partial rebuilds. See the Buildroot website for details.

Creating a BeagleBone MicroSD card

After the build completes successfully, you should have a .img file. This is a binary image that should be written to the beginning of the MicroSD card. To do this, insert a MicroSD card. You will need to unmount any partitions that were auto-mounted before writing the .img file. The commands should be something similar to the following:

find /dev -name "sdX?" -exec umount "{}" ";"
sudo dd if=xxxxxxx.img of=/dev/sdX bs=128k

Replace sdX with the device for the MicroSD card. This can be found by looking at the end of dmesg after plugging in the MicroSD card. Be careful with this since a typo in the device file can make the system unbootable.

Updating the Root FS on the BeagleBone

The Root FS is configured to mount read-only on the BeagleBone. This is done to prevent data corruption from unsafe shutdowns and as a reminder that all configuration and new packages have to end up in the buildroot configuration.

Since this can be annoying during debug, the rootfs can be mounted by running:

mount -o remount,rw /
Jump to Line
Something went wrong with that request. Please try again.