Krescue - take full control of your VIM device! easy way to install ANY OS! + back/restore your system

Krescue which stands for “Khadas Rescue”, is an extremely small 21mb operating system that gives you full control over your Khadas VIM1, 2, 3 and 3L!

Credit: @hyphop

Main Features:

  • Dump EMMC memory contents to an SD card, USB, LAN host.
  • Restore .img.gz into an EMMC on another device.
  • View device information.
  • Rescue shell for expert users.
  • Shell access via UART, USB network, and LAN network.

Basic Steps to Boot Krescue:

  1. Download an appropriate image for your device from
  2. Burn this image to an SD card, using rufus, dd or Etcher.
  3. Plug in the SD card, USB-C power, and HDMI into your VIM device.
  4. Boot your VIM device into MaskROM mode (please read!!!).
  5. Use an IR remote control or USB keyboard to navigate the UI menus.

Introductory Video:


Is it possible dump SD/USB image to another SD/USB storage?

yes ! sure it possible ! but u can can do it more easy without krescue ! because SD USB is removable and can attach anywhere :wink:


Hello! From video, I realized that you can make an EMMC VIM image from a network from a remote terminal, and burn it to a NAS. Is this a possible scenario? Thanks for the cool work !!!

1 Like

yes its very easy !!!

simple example how to

curl http://krescue.lan.ip/cgi-bin/disk/rd/mmc > vim_raw_mmc_image.bin

or gzip on the fly

curl http://krescue.lan.ip/cgi-bin/disk/rd/mmc | gzip -c >

Great, tomorrow I will try it !!!


I tried the VIM3 version. While it boots when I use the serial method(kvim3# run update) and also boots if I use the keys method for standard update(hold power, short press reset, release power after 5 seconds), I could not get it to boot using TST.

It works great! I made an image of the eMMC. Used Krescue to clean(Erase) the eMMC. Then used Krescue to write the image back to the eMMC.
Krescue conveniently boots automatically if eMMC is empty.
After writing the image to eMMC, everything is as it was, all apps, etc were running as before the eMMC wipe.

Great job @hyphop


TST ??? Plz clarify ? What is TST :wink:
If USB cable connected to host machine power key booting not work for krescue but have some tricks just pull USB cable slowly only until power pins after booting u can plug for full length (USB connector pins have diff length for power and data) if uboot detect USB data pins he goto amlogic USB burn mode


I speak of Terry’s Smart Tweezers. This is mentioned in step 4 above.:slightly_smiling_face:

I was not using host PC. VIM3 powered from Khadas 24w PD power supply and USB-C to USB-C cable.

1 Like

OK )) TsT for VIM1 VIM2 not same as for VIM3

1 Like

VIM3 has TST function. But since VIM3 uses a different method, maybe @tsangyoujun can modify the above instructions to indicate that TST not used for VIM3 for Krescue.:slightly_smiling_face:


Привет hyphop! The SD card is formatted on 2 logical drives, the VIM 3 image about 32 GB EMMS took 11 GB on the memory card. The full image was recorded for 30 minutes, recovery - 15 minutes.

But I can’t log in to the LAN on the krescue, the password is 12345678 - but the SSN connection is not established.

Вообщем с сетью у меня пока не получается вход, ни через lan, ни через веб морду, по UART не пробовал. Под виндой после записи имиджа SD карта не читается, только через diskpart восстанавливается, пока ограничился записью имиджа на NAS, с него на карту,с карты бэкап.
Спасибо за отличную работу!!! Thanks for the excellent work !!!
П.С. после бэкапа на CD карту она открывается только на устройстве с которого сделан бэкап? Не могу получить к ней доступ с других систем. Это защита?:sunglasses:


My use case is in its current state: I use a 64 GB class 10 SD card, write Krescue and good system images (Android, Ubuntu, etc.) to it and store it as an emergency disk in the cabinet. It reminded me of Noron Ghost of Windows 98 and the good old DOS from my youth! Thank!!!


Yea I really like what @hyphop made! Norton Ghost, exactly what I was thinking. :smile:

1 Like

It is kool and needs a kooler name was thinking, :sunglasses:

KresQ less to type

What say you @hypohop :upside_down_face::upside_down_face:


tnx for alternative name :wink: if somebody have any cool idea about Krescue name - wellcome ! maybe we can change it later :wink:

1 Like

Krescue looks great! Thanks for the pointer, @tsangyoujun.
Q: Does it work with EDGE-V? ex: Could it be used to back up a currently running Ubuntu OS & configurations onto a local SSD, then erase another OS and restore the original from SSD back onto eMMC?
Also, can Krescue be controlled via keyboard, instead of Remote Control?
That’s exactly what I need.:sunglasses:

1 Like

No intended association with Qanon, right? Been seeing lots of Q’s online lately.
Just sayin.:face_with_raised_eyebrow:

Now Krescue only for VIMs board
I can add edge soon !


@TheHermit yes a USB keyboard works just fine :smile:

1 Like