Skip to content
Viktor Verebelyi edited this page Aug 25, 2022 · 6 revisions

Welcome to the headunit-desktop wiki!

Getting started

There is a ready to use image available, follow these steps to get it working:

  • Download the Raspberry Pi image which is based on Raspbian Buster Lite from here (currently not available)

  • Flash the image to an SD card following the usual steps for flashing Raspbian : https://www.raspberrypi.org/documentation/installation/installing-images/

  • Insert the SD card into your Pi and power it up

  • Headunit-desktop will automatically start with Raspbian

Connect to the Pi remotely

In some cases you might want to connect to your Pi remotely, you can do so by following these steps below:

(Warning! Following these steps might leave your Pi vulnerable as anyone can login with default credentials. Please see the Passwordless SSH access page in the Raspberry Pi docs)

You will need to enable SSH first:

Enable SSH on a headless Raspberry Pi (add file to SD card on another machine)

For headless setup, SSH can be enabled by placing a file named ssh, without any extension, onto the boot partition of the SD card from another computer. When the Pi boots, it looks for the ssh file. If it is found, SSH is enabled and the file is deleted. The content of the file does not matter; it could contain text, or nothing at all.

If you have loaded Raspbian onto a blank SD card, you will have two partitions. The first one, which is the smaller one, is the boot partition. Place the file into this on

Source: https://www.raspberrypi.org/documentation/remote-access/ssh/

The login use the following username/password:

Username: pi

Password: raspberry


For building your own Raspbian images see: viktorgino/pi-gen

For details on how to compile HUD from source please go to the Building Headunit Desktop page