Improve this doc
I need help with

Troubleshooting information for Raspberry Pi CM4 IO Board

Terminal Closes On Update

When you push updates, the terminal session is automatically closed. To restart the terminal session, simply close the terminal session and restart it once the update is complete.

Can't Login to the Dashboard

In some cases social logins can be disrupted or completely borked by Adblocker or browser extensions such as BrowserShark. Make sure to disable these extensions or whitelist the * domains.

I get $'\r': command not found when my device tries to run scripts

Line endings differ between Windows and the Unix-y world (they used to be different again for Mac but not for many years), which can result in issues. E.g. a user seeing something like: /usr/src/app/ line 2: $'\r': command not found

To resolve this, you will need to configure git to automatically convert line endings. In order to configure this for Windows have a look here:

Device keeps dropping off wifi

If your device keeps dropping offline, it may be worth switching to a 5GHz band wifi dongle, as we have seen cases where 2.4GHz gets badly affected by surrounding noise.

Unsupported Syscall: 384 from qemu on builder

The qemu: Unsupported syscall: 384 is a warning that the getrandom(2) system call is not implemented by our emulation layer, qemu. It can be safely ignored. Since it's a fairly new system call (introduced in kernel 3.17), apt and almost all programs automatically fall back to reading from /dev/urandom when this syscall fails.

Help! My device won't show up.

If your device still hasn't shown up on your dashboard after 10 minutes, something is definitely wrong. First check that you entered the WiFi credentials correctly (if you need help fixing your credentials, see WiFi Help) and ensure that your network meets these basic requirements. It may also be worth checking the LED error notifications.

If you have an HDMI screen attached, you should see balena logo on the screen when the device boots. If instead you see rainbow colors or a blank screen, it could mean that the SD card was not burned correctly or is corrupted.

balenaOS boot issues with Rev 1.1 of Raspberry Pi Compute Module 4 hardware

Balena supports the use of the Raspberry Pi Compute Module 4 (CM4) on the Raspberry Pi CM4 IO Board. In April 2022, Raspberry Pi released hardware Rev 1.1 of the CM4. This revision of the module requires balenaOS v2.91.1 or later. Earlier versions of balenaOS will not boot.

To determine if you have hardware Rev 1.1 of the CM4, follow either of the steps below:

  1. If your CM4 has a Dialog DA9090 power management controller (see image below), then your CM4 is Rev 1.1 or later.
  1. Run the following command in Raspberry Pi OS (release date April 4th 2022 or later): The output should confirm the hardware revision.
$ cat /proc/cpuinfo | grep Model 
Raspberry Pi Compute Module 4 Rev 1.1

For more information about the CM4 Rev 1.1, please refer to the "CM4 Revision 5 PCN" in the Product Information Portal by Raspberry Pi.

If you still can't get your device online, come on over and talk to us on our support channel.