Frequently Asked Questions

Where can I find “getting started” guides?

These guides will be helpful for anyone learning how to use a Khadas SBC for the first-time.


Tip: In addition to reading our documentation, you’ll find many helpful people on our Khadas Forum.

How to use an SD-card to expand eMMC storage?

Using Android OS, you can use SD-cards to augment the limited amount of storage on the eMMC. Make sure that you’re using a modern “high-speed” SD-card; something like a microSDXC UHS-I card will be suitable for this application.


  1. Insert your SD-card into your VIM1/VIM2/Edge-V
  2. Open the “Android-Settings” App (Gear Icon)
  3. Select “Storage & Reset”.
  4. Select your SD-card under “Removable Storage”
  5. Select “Set up as device storage”

Tip: If you’ve done the above steps correctly, your SD-card will become a seamless part of your SBC’s eMMC storage. Exercise caution when unplugging your SD-card as some files and photos will become inaccessible!

How to change/upgrade the Operating System?

Depending on your use-case, you may want to change/upgrade your Android OS to Ubuntu Mate, or even run a dual-OS configuration. We refer to “operating system” files as “Firmware Images“, or .img files. On our server, they are compressed into .7z containers, and will require WinRAR to unpack on Windows OS.

Tip: Changing operating systems will erase ALL the data on your eMMC. Unless the OS is meant to run from a Bootable SD-card (Booting Card), be sure to back-up all your data before following the instructions below.

VIM1/VIM2 Upgrading Instructions:

  1. Place VIM into Upgrade Mode.
  2. Two ways to upgrade:

Edge Upgrading Instructions:

  1. Place Edge into Upgrade Mode.
  2. Two ways to upgrade:

eMMC image versus a SD/USB image?

eMMC image: An eMMC image should be burned directly to the eMMC using a USB-C data cable, from a Ubuntu or Windows Host. It must not be burned into an SD-Card. For Example: Android and Ubuntu distributions containing the EMMC mark.

SD/USB image: An SD/USB image should be copied into an SD-Card, before that card is then used to reformat the eMMC storage with a new OS. For Example: Armbian, Ubuntu distributions containing the SD_USB mark, as well as LibreELEC and CoreELEC.

How to bootup SD/USB images?

In order to bootup from SD/USB images, you need Android (V180209 or newer) or Ubuntu (V180531 or newer) running on your eMMC with Multi-Boot activated. Please refer to Boot From External Media for more information.

Help! My SBC won’t power-on!

Recommended VIM1/VIM2 Power Supply

Although your VIM1/VIM2 SBC is compatible with various types of power supplies, these are the recommended specs for the best performance-output and stability.

  1. 5V, 2000mA Power Adapter
  2. USB-A to USB-C Cable

Learn More:

Recommended Edge Power Supply

Although your Edge SBC is compatible with various types of power supplies, these are the recommended specs for the best performance-output and stability.

  1. USB-C 45W Power Adapter (USB Power Delivery Specifications)
  2. USB-C Cable (Male to Male)

Learn More:

My Bootloader is Damaged

Your SBC may also fail to power-on if the bootloader is damaged. In such cases, you’ll need to place your SBC into Upgrade Mode using the MRegister, and then re-install the Operating System.

Learn More:

Help! I turned on WOL, and now there’s this blue light?

vim2 blue light

If you’ve turned on Wake-On-LAN (WOL) in your VIM2, it will no longer power-on automatically when you connect a USB-C cable to it. Instead, you’ll merely see a blue light activate indicating that there is electrical power being supplied to your SBC.

Furthermore, your VIM2 will only power-on under these conditions:

  1. You physically press the power button, after seeing the blue light.
  2. You send a magic packet to turn it on via LAN (Ethernet cable must be connected, and sending device must be on the same LAN as your VIM2)

Learn More:

How to build my own Ubuntu/Debian images?

Please refer to: Build Ubuntu/Debian Images.

How to connect to Wi-Fi from the Linux Command Line?

Please refer to: Connecting to Wi-Fi from CLI

How to setup Bluetooth from the Linux Command Line?

Please refer to: Setup Bluetooth from CLI

How can I check my MAC address?

Please refer to: How to Use WOL.