Armbian on the MangoPi MQ Pro!

by Bret
Published: Last Updated on 6 minutes read

Boring Introduction

After spending the last 24 hours trying to bodge together a Gentoo build in the worst possible way, it turns out there’s a working build of Armbian that will run on the MangoPi MQ Pro and everything was a waste of time. Do I care? Nope, not too much, becauuuuse..

Armbian user balbes150 has been working away on Armbian builds for other RISCV D1 boards such as the Nezha, LicheeRV Dock, sharing his knowledge with the Armbian forum users and as luck would have it, they also run on the MangoPi MQ Pro!

Image Downloads

There are a few to choose from, both Ubuntu and Debian flavours are represented and if you want a desktop environment? Sure, they’re there too, though I can’t say you’re going to have a great time with a single 1GHz RISCV core but if you’re into that kind of thing, more power to you. I’ve tested the jammy desktop and headless versions and both work, I have no reason to believe the others don’t but if you have any issues, please leave a comment!

The following images are all linked directly from the author’s repository via I’ve mirrored all of them in Spain, Singapore, and Australia, though if your download speeds aren’t great from there.

Headless / CLI


XFCE Desktop


Issues Noticed So Far

  • The first boot is going to take some time! Do make sure you’re watching it via HDMI if possible so you can see what it’s doing as depending on the size and speed of your SD card, it may take a while to boot and resize.
  • Straight out of the gate there seems to be an issue with the wireless interface only detecting certain networks. This seems to be related to band-steering and 2.4GHz/5GHz networks sharing the same SSID. An easy fix is having a separate SSID for 2.4GHz (or a guest network running on that if you have the ability to) but when we have further information, we’ll update it here.
  • When shutting down, balbes150 notes that it doesn’t quite complete properly and you’ll still see an image on the screen.
  • When connected to the UART serial console, the HOST USB-C port will not function. You will need to un-plug your serial cables and enable the USB port or try plugging in and out the device a few times until it turns on and activates.
  • The activity light will not come on on the board so don’t be alarmed. Just plug in a USB ethernet adapter or HDMI cable and you’ll be able to access the device.
  • There are possible locale issues due to packages being missing. RichN via the RISCV Discord (definitely join if you’re interested in RISCV fun!) has mentioned that he’s already working on fixing this and including additional plugins for the desktop environment.


balbes150 has done some great work in getting these images together and whilst they weren’t built specifically for the MQ Pro, they work well enough and everything I’ve tested so far within Armbian has been what I’m used to (in the headless images anyway, I only checked to see if the XFCE image booted) so bravo to the guy.

The default password when logging in to Armbian if you’re not familiar with it is 1234 and you’ll be prompted to change that and set up an account with your chosen shell on the first login.

This will be a living document and no doubt there’ll be new builds so as soon as we discover fixes for known problems, or we encounter new ones, I’ll update this page with timestamps.

Enjoy your MangoPi boards (finally!)

You may also like...


Ray Knight 25/06/2022 - 01:43

Thanks for the link to Armbian. I just received 2x Mango Pi MQ1PL (512MB) version and 1x MangoPi MQ1PH (1GB) version. They are all marked 20220415 v1.3 and are the Pink version. I ordered a 1GB Red version earlier from a different vendor and it still has not shipped! I’m hoping to confirm that this will work with Pi Zero hats that use pogo pins as it appears to have the right contacts unlike other Pi Zero format boards like the BPI-M2 ZERO and Radxa Zero.

Bret 25/06/2022 - 11:23

Hm, hopefully the other vendor ships it out, the official page only had 10 1GB versions listed and they were made from RAM chips that were from testing boards so it would be odd for them to try and scalp those :(

Which hat were you looking to use exactly? I should check if my Pi Zero USB Dongle works!

Ray Knight 17/09/2022 - 08:29

I have now confirmed that a few of the WaveShare Pi Zero hats that make use of pogo pins do work with the MQ Pro. I suspect they will also work with the MQ Quad as well. I am using the and

Orlando 07/07/2022 - 23:43

HI Bret,
Thanks for your post. I managed to set Armbian up and logged in, Yet, I’ve noticed the system is hardly responsive :-( Has this been your experience too? Like the GUI responded to open the applications menu… and that was it … It went frozen.

Curious to hear others’ experiences. Thanks,

Orlando 07/07/2022 - 23:59

After a reboot, XFCE started, and things worked as normal. hope it stays like that :-)

Bret 08/07/2022 - 09:53

Ah, glad to hear you got things working! I’ve not tested the desktop side of things at all really, except for checking that the images booted. I will definitely look into adding some testing like this for all boards that support it. Is there anything in particular that you’d find useful benchmark/testing wise?

Chaos_Muppet 17/09/2022 - 08:18

Thank you so much for this post. I am not an experienced linux user, but I was able to get the jammy headless and desktop images working on my boards.

I’m currently struggling to find a suitable GPIO python package. RPi.GPIO cannot install (makes sense, but I thought I’d give it a shot). I also tried installing pyGPIO (, and met with a similar failure while running the installer.

I’m sure I need to do more reading on RISCV, and using a more established machine would be better for my tinkering projects, but I’m excited to learn more!

Bret 17/09/2022 - 11:39

Comments like this are great to wake up to on a weekend! I’m glad that it helped out and you’ve been able to get your board up and running :D Sadly I haven’t touched anything on the GPIO just yet so I can’t offer much help there.. If you do figure it out though feel free to come back and let me know!

Marco 28/10/2022 - 03:24

FYI: the RISCV Discord link mentioned above is no longer valid.

Bret 28/10/2022 - 16:32

So it is, I’ll update it now! is the current one

chobogami293 08/12/2023 - 19:07

Thank you for this guide. I was able to install

Armbian 22.08.0-trunk Jammy with Linux 6.1.0-rc3-d1

with the links provided and a little hunting around. First boot was unusual. I went Ethernet –> Usb Adapter –> USB A to USB C –> Host port on the MangoPi. Once the little lights on the ethernet port started blinking, I checked for new leases on the router. The default hostname is “nezha”. I was able to ssh in, complete configuration, bring up the wireless, and disconnect the cable.

Bret 08/12/2023 - 21:55

Hey! Awesome, I’m glad to hear you got it working with a newer image. I should probably update this piece to include the latest links, but I’d need to double check that they work (though I have full confidence in balbes :D)

nabiullin 25/12/2023 - 20:08

hi! is it possible to build actual armbian image for T113 Allwinner core ?


Leave a Comment