Install ArchLinux on BeagleBone Black

The installation of ArchLinux on ARM based embedded devices is well documented online, but I always forget the extra and optional steps that are assumed to be known.

ArchLinux is a great operating system for low-cost ARM based embedded devices, such as the Raspberry Pi and BeagleBone Black. The development team for the ARM port is doing an excellent job optimizing and updating the package repository.

The official website has instructions for installing ArchLinux ARM on the BBB, but is missing the details for post-installation steps that are generally not known by users who are just starting with ArchLinux. The best, most detailed and up-to-date ArchLinux installation tutorial I found is the one written by The Mukt, but at the time of this writing it appears to be offline.

Below you can find the condensed summary of the installation steps that I usually take on BeagleBones.


Before you can start with the installation, you have to prepare a bootable SD card with ArchLinux that will be used to install the operating system. If your desktop PC is also an ArchLinux system then you can follow the SD Card Creation steps on the official web site. Insert the SD card into the BBB and power on the system.

Many developers always boot their BBB’s from an SD card, and if you are one of them, you can skip the next section. I prefer to install the OS on the on-board 2GB or 4GB eMMC flash memory, so that I can use the SD card slot for other things.

Install ArchLinux to eMMC

The on-board eMMC already has boot and root partitions by default, but if yours are modified for some reason, you need to re-create them. I suspect that you already know what you are doing, but if you are not sure, check out the Partitioning page on the ArchLinux wiki.

Once the partitions are in place, you need to format them. I use the VFAT file system for the boot partition, and EXT4 for the root partition:

Now download and install the bootloader:

You can safely ignore any error messages about changes in ownership, and unmount the boot partition:

Next, download and install the root filesystem:

You can safely ignore the locale related warning and errors and unmount the root partition:

Now power off the BBB, remove the power chord, remove the SD card and plug the power chord back in. Your BBB should now boot from eMMC.

Configure ArchLinux

Now that the system is up, log in as root / root and change the password:

You can take a look at the system log to check whether there are any problems:

Then edit the package mirror list and uncomment the download servers that work best for you:

Set the system’s language and locale:

Next, identify your time zone and set it permanently, i.e. /usr/share/zoneinfo/America/New_York:

Finally, set the machine’s host name:

Optional Post-Install steps

Your BeagleBone Black is now fully set up and ready to go. I usually perform the following additional steps before putting it to work.

Install the base-devel packages if you want to compile code on the BBB:

Install sudo, because you don’t want to be logged in as root all the time:

Install auto completion for bash, so it is easier to find packages:

Finally, create a new user account that you will use to log in from now on, and set its password:

And that’s it!

Related Resources

Leave a Reply

Your email address will not be published. Required fields are marked *