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:

VIM3L - Opening Up New Possibilities for DIY-HTPC Enthusiasts
Khadas Vim3 + CoreElec all work!
Can connect ssd without expansion card
VIMs Ubuntu 18.04 V191231 Release
Power on vim3 by ir is possible?
No USB on 5.9.0-rc2, running Debian built from scratch
Krescue, VIM2 v1.2, dump SD-Card > EMMC ==> BOOT ISSUE
VIM3 upgrade via USB-C failed when writing to rootfs
Vim3 pro - ubuntu sdcard hdmi output green screen
LibreELEC for Khadas EDGE (RK3399)
Usb 3.0 port speeds
ERROR Amlogic device not found
2019 KFCI: Bonus for the Top 10 Contributors to Khadas Community
Blue Indicator LED different than Beginners Guide
Build vim2 firmware including root support
Android image for SD Card
Krescue on bootable USB?
Can i change the LED order?
Volumio on SD card. is it possible
Build vim2 firmware including root support
Ubuntu on EMMC in VIM3 Pro
Khadas Vim 2 Dead?
VIM2 1.4 how to clone it?
Vim2 won't boot
VIM2 not boot up
Boot sequence between SD and eMMC - VIM2
Boot sequence between SD and eMMC - VIM2
[ROM] SC VIM3 Pie "Normal" Debug Build v8 20211122
VIM3 Support & Linux & RS-232?
Ubuntu 16.04 Image with 4.9 kernel
Build vim2 firmware including root support
Upgrade Ubuntu latest image
G_mass_storage module file not found
Manjaro Linux - KDE-Plasma & XFCE for VIM1
Is there any way to clone emmc flash os from VIM3
Mcp2515 CANbus modul and wrong clock 5500000 instead of 8000000
SD/USB固件写入到eMMC 后无法正常启动,反复重启
What is the trick to get VIM1.KRESCUE.SD.IMG.GZ to work?
VIM3 ubuntu系统如何复制整个系统?
VIMs Ubuntu 20.04 V1.0.9-211217 OTA Release
Cannot install LINUX on VIM1
Changing OS on vim1
How to start system from SD Card? Volumio
VIM3 V13 can't install ubuntu
Latest Edge-V image .. will changes be added to FreeBSD upstream?
Community Armbian 21.02.3 MAINLINE Image For Khadas VIM3 Pro arm64 Native - WITH HDMI AUDIO!
Community Armbian 21.02.3 MAINLINE Image For Khadas VIM3 Pro With 32-bit Userspace
VIM3L - Upgrade Mode defaulting to Android Recovery
Can we use n2+ armbian on vim3 with little changes?
VIM3: Not powering ON

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