The Wandboard comes in several different models and atleast the (original) Quad version is officially supported by Debian. This means you'll find instructions on how to get started with it in the official Debian Installer documentation. This page is intended to gather quick-start information and other practical info for the impatient reader.

Why installer, why not random image

It's very common and likely the first hit you see when googling Wandboard and Debian is a page describing where you can download an already existing SD-card image. It likely also tells you the existing users and passwords in the image. Why is it a bad idea to use these? Well primarily there's no easy way to verify these images aren't full of backdoors or other malicious contents. You may choose to trust them, but if you want to be more on the safe side then you should use official Debian software and that means either using the installer or manually constructing an sd-card image from scratch using debootstrap to build a rootfs and then carefully placing the bootloader, kernel etc at the right offsets. The recommendation for the easiest and safest route is to use the official Debian Installer, see below.



Downloading installer

The debian installer documentation chapter 5.1.5. Using pre-built SD-card images with the installer is one of the quickest ways to get started. Download these files from the download area :

Once you have there files you need to uncompress and combine them to generate a complete image:

zcat firmware.Wandboard_Quad.img.gz partition.img.gz > debian-installer-wandboard.img

Write installer to sd-card

Insert SD-card in Linux computer. Look up which device just appeared in /dev/sd*. (In this guide we'll write /dev/sdX which you should replace with your sd-card device.)

Overwrite the data on the sd-card with the installer:

sudo dd if=debian-installer-wandboard.img of=/dev/sdX bs=1M

Make sure data is completely written to card (three times for superstition):

sudo sync ; sudo sync ; sudo sync

Starting installation

Hook up the wandboard serial port via null-modem cable to your computer where you'll be running Putty (or equivalent) to get serial console access. Also hook up network cable for internet connection. And make sure to put the SD-card in the right slot. There are two card slots, one on the carrier board and one on the smaller main board. Use the one on the smaller main board. Finally hook up the 5V power cable and you should be seeing text appear in your serial console program.

We assume you're familiar with the debian installer which will guide you through the installation. Just follow the guide.

Graphical Environment

Most of the needed parts should be reverse engineered by now to have a fully libre graphics stack running on Wandboard.

There are still some issues with this in Debian though that makes it not work "out of the box". This section intends to document missing parts and possible workarounds.

xorg driver

The xorg video driver needed is called xf86-video-armada. General modesetting driver is not enough (why?). TODO: This driver has not yet been packaged for debian! The upstream repository is located at http://git.arm.linux.org.uk/cgit/xf86-video-armada.git/


The graphics stack parts for 3d on the Wandboard was first merged in mesa 17(-rc). You will also need the libdrm parts that first appeared in 2.4.74-2 (see #852685).

As of this writing the newer mesa and libdrm versions are not available in any release and you will thus need to fetch them from Debian Experimental. (They should install fine on a stretch system.)


The continuous memory allocator used by the graphics drivers needs a memory chuck to use. This is not enabled by default in Debian and you will need to set up your system to pass the cma= kernel cmdline option, eg.: